1. Media Server Core

The Mini‑Pi Media Server provides a complete media ecosystem:

• DLNA streaming via MiniDLNA (videos, music, photos)
• Multiple simultaneous clients supported (4 tested)
• Samba file sharing for easy drag‑and‑drop media management
• Unified media folder used by DLNA, Samba, and the web UI

This makes the Pi behave like a tiny NAS and media hub, even in a car or offline environment.

2. Web Interface & Customization

The built‑in web UI is lightweight but surprisingly capable:

• Custom backgrounds using images or MP4s placed in the DLNA “pictures” folder
• Animated backgrounds supported
• Live system indicators:
  • System Load LED (green/amber/red)
  • CPU temperature warning above 75°C
  • Disk usage percentage
  • Media counts (videos, music, photos)
  • Wi‑Fi connection status
  • USB sync status pop‑ups
  • Server sync status pop‑ups

Everything updates automatically, giving users a clear view of what the server is doing.

3. Automated Media Syncing

This is one of the most powerful parts of the system.

Nightly Rotational Sync (if configured)

• Runs at a user‑defined time (e.g., 1am) every night
• Pulls down new MP4/MKV files from a NAS / server
• Syncs only files newer than a user‑defined retention window (e.g., last X months)
• Keeps the library fresh without manual intervention

USB Auto‑Sync

• Plug in a USB drive → automatic import begins
• Web UI shows live sync progress
• Ideal for offline setups or quick media transfers

4. Intelligent Transcoding & Remuxing (if enabled)

This is where the project really steps into “appliance” territory.

Smart MKV → MP4 Pipeline

• Runs the night after the sync job
• Detects whether video/audio already match target formats
• Remuxes when possible (no re‑encode)
• Re‑encodes only when necessary

Performance

• Pi Zero 2W: ~8 fps using hardware encoding (2 threads)
• Pi 5: ~50 fps using software encoding (2 threads)

Concurrency Guard

• If an encode job is still running at midnight, a new one will not start
• Prevents overload, SD wear, and UI lag

This pipeline is fully automated and requires no user input.

5. Network Intelligence

The server is designed to always be reachable:

• Wi‑Fi fallback mode If Wi‑Fi doesn’t connect within 50 seconds, the Pi automatically switches to AP mode. If configured
• Perfect for car installations or travel where home Wi‑Fi isn’t available.

6. Server Administration

A “Manage Server” button in the web UI opens Cockpit, giving users:

• File browser
• Service management
• OS updates
• Logs and monitoring
• User management

This makes the system fully maintainable without SSH.

7. One‑Command Installer

The entire system can be rebuilt in minutes using a single command that:

• Downloads the latest GitHub release
• Extracts and installs / upgrades everything
• Sets up services and cron jobs
• Prepares the web UI

This makes the server effectively stateless — if the SD card dies, just flash Pi OS Lite, run the command, and re‑sync your media.

8. Design Philosophy

The Mini‑Pi Media Server is built around:

• Low power usage
• Automation
• Reliability
• Ease of recovery
• Customization
• Zero‑maintenance operation

It behaves like a mini NAS + DLNA server + sync engine + transcoding appliance, all running on a Pi Zero 2W.