Releases: hackboxguy/media-mux
Media-Mux v02.1.0
What's New in v2.1.0
🎮 Touch-Friendly OSD Controls
- Sync Button - New touch-friendly "Sync" button in Kodi video player OSD
- Stop All Button - New "Stop All" button to stop playback on all screens simultaneously
- Master-Only Visibility - OSD buttons automatically hide on slave devices (only visible on master with USB mounted)
- Keyboard Shortcut - Press 'S' during video playback to trigger sync immediately
✨ Improved User Experience
- No Startup Prompts - Pre-configured Addons database eliminates "Do you want to enable this addon?" prompts
- No Version Check Popup - Kodi version check addon disabled by default
- Accurate Device Count - Fixed duplicate localhost counting (shows correct 3/3 instead of 4/4)
🌐 Self-Hosted Mode Enhancements
- Automatic master/slave role detection based on USB storage presence
- Integrated DHCP, DNS, NTP, and DLNA services on master device
- NTP time synchronization for accurate playback coordination
📦 What's Included
- Raspberry Pi OS Bookworm (arm64-lite) base
- Kodi media player with Estuary skin (patched for Sync/Stop buttons)
- Media-Mux Sync addon (
service.mediamux.sync) - All sync/stop scripts and dependencies pre-installed
- Self-hosted networking (dnsmasq, minidlna, chrony)
- Avahi/mDNS for automatic device discovery
🚀 Quick Start
- Flash image to SD card using balenaEtcher or Rufus
- Insert SD card into Raspberry Pi 4
- Connect Ethernet, HDMI, and power
- Repeat for each Pi (all use the same image)
Master/Slave auto-detection:
- Pi with USB storage attached → Master (provides DHCP/DLNA)
- Pi without USB storage → Slave (DHCP client)
🎮 How to Use
- Start playing a video on the master device
- Tap screen (or press any key) to show OSD
- Click Sync to synchronize all screens
- Click Stop All to stop playback on all devices
📋 Changelog
ac3a2d6 Update README with v2.1.0 image link and Kodi addon docs
ed81bd1 Update INSTALL.md to v1.3 with recent improvements
66622ae Add proper descriptions to Sync/Stop OSD buttons
6197779 Show Sync/Stop OSD buttons only on master device
4b064a2 Use pre-configured Addons33.db template for Kodi addon settings
23526e4 Fix Kodi addon database handling to prevent boot crashes
a692408 feat: auto-enable Kodi addon and disable version check popup
d6d24ba feat: add Stop All OSD button and fix device discovery duplicate
582fb1c feat: add Kodi OSD sync button for touch screen control
🔗 Documentation
Media-Mux v02.0.0
Media-Mux v2.0.0 - Self-Hosted Mode
Release Date: 2026-02-07
This major release introduces Self-Hosted Mode, eliminating the need for an external pocket router. One Raspberry Pi automatically becomes the network master when USB storage is attached.
What's New
Self-Hosted Architecture (Mode B)
- No external router required - The pocket router (GL-MT300N-V2) is now optional
- Automatic master election - Pi with USB storage becomes the master at boot
- Same image for all terminals - Flash identical SD cards, roles are auto-configured
- Built-in services on master:
- DHCP server (dnsmasq) - 192.168.8.100-200
- DNS server (dnsmasq)
- NTP time server (chrony)
- DLNA media server (minidlna)
Time Synchronization
- All terminals sync their clocks from the master via NTP
- Ensures accurate playback coordination across devices
Simplified Deployment
- Single Ethernet cable per Pi (with PoE HAT) provides power + network
- Move USB to a different Pi to change which one is master
- Supports both external router mode (v1 style) and self-hosted mode
Upgrade Path
From v1.0.0:
- Flash this new image to all SD cards
- Boot with USB storage attached to desired master Pi
- System auto-configures - no manual setup needed
Existing external router setups continue to work - the system detects whether USB storage is present and configures accordingly.
Hardware Requirements
| Mode | Hardware |
|---|---|
| Self-Hosted (new) | PoE switch + PoE HATs for each Pi |
| External Router (v1) | Pocket router + network switch |
Image Details
- Base OS: Raspberry Pi OS Bookworm (64-bit Lite)
- Kodi Version: 20.x (Nexus)
- Supported Hardware: Raspberry Pi 4 (2GB+), Pi 3, Pi 5
- Image Size: ~1.2GB compressed
Known Limitations
- No automatic master failover if master Pi disconnects
- No web dashboard for status monitoring
- Master role determined by USB presence only (no manual pinning)
Documentation
Full Changelog
- feat: add self-hosted mode with automatic master election
- feat: add NTP time synchronization (chrony)
- feat: add built-in DLNA server (minidlna)
- feat: add built-in DHCP/DNS server (dnsmasq)
- fix: minidlna startup permissions for /var/lib/minidlna
- docs: update README with Mode A/Mode B architecture diagrams
- docs: add self-hosted troubleshooting section
Media-Mux v01.0.0
Pre-built Raspberry Pi-4 image v1.0(based on 2024-10-22-raspios-bookworm-arm64-lite) with media-mux customization