Skip to content

Media-Mux v02.0.0

Choose a tag to compare

View all tags
@hackboxguy hackboxguy released this 07 Feb 14:58
· 9 commits to master since this release
v2.0.0
7452579

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:

  1. Flash this new image to all SD cards
  2. Boot with USB storage attached to desired master Pi
  3. 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
Assets 3
Loading