Close
0%
0%

Mini-PI Media Server

Mini-PI Media Server for use on home network or as a wifi access point to stream media from

Similar projects worth following
A low-power, dual-interface media server appliance that functions as a permanent Wireless Access Point (WAP). It bridges high-speed Ethernet internet to wireless clients while serving as a centralized hub for media streaming, file management, and automated library curation.

Core Features
Dual-Network Gateway: Operates as a transparent bridge; routes internet from Ethernet to WiFi clients while hosting all services (DLNA, Samba, Web) on both interfaces.

Omni-Channel Ingestion: Upload via Web Browser, Samba (NAS), Cloud Sync, or auto-mounting USB storage.

The "Midnight" Engine: * Smart Conversion: Automated batch-transcoding of .mkv to web-native .mp4 every night at 00:00.

Metadata Enrichment: Nightly syncing of movie posters, IMDB ratings, and synopses.

Universal Access: Integrated MiniDLNA, Apache, Samba, and Cockpit for hardware-agnostic streaming and management.

The Mini-Pi Ecosystem: Pro-Grade Media for Low-Power Hardware

The Mini-Pi Media Server is a low-power, "appliance-style" media ecosystem. It transforms a £15 Raspberry Pi Zero 2W into a high-performance NAS, Torrent box, and DLNA hub drawing less than 2 watts. Whether it’s for a home network, a hotel room, or a car full of kids with tablets, Mini-Pi delivers a seamless streaming experience.

1. Core Media & Download Engine

  • Universal Streaming: Powered by a tuned MiniDLNA instance, streaming HD video, music, and photos to Smart TVs, game consoles, and mobile devices.
  • Integrated Downloads: Optional Transmission-Daemon support allows you to download content directly into the /var/lib/minidlna library for instant availability.
  • Optional Sync via Google Drive, Mega or One Drive: From the cloud to as may mini-pi servers as you want. every 30 minutes
  • Unified Storage Architecture: A centralized directory keeps DLNA, Samba, and the Web UI perfectly synced—no ghost files or broken paths.

2. v5.0 Smart Web Interface

The Web UI isn't just a file list; it's a rich, interactive gallery:

  • Modern UX: Features a dedicated synopsis overlay, intelligent poster gallery, and customizable backgrounds with smooth fade-ins and transitions.
  • AI-Driven Metadata Scraper: A zero-config Python engine runs nightly (5 AM), fetching high-quality movie posters (via DuckDuckGo), 4-sentence plot synopses, IMDB ratings, and Rotten Tomatoes scores.
  • Easy Content Management: * Web Uploads: No technical skills required. Users can upload media directly via the "Upload" button to the Music, Pictures, or Video directories.
    • Samba (SMB): Full network transparency for power users who prefer drag-and-drop from a PC or Mac.
  • Smart Playback:
    • Resume Function: The browser remembers where you left off and prompts to resume partially watched films.
    • Lock-Screen Controls: High-fidelity music playback with transport controls even when your device is locked.
  • Upload media to any of the main folders (Music, Pictures, Video) folders from any device

3. Intelligent Automation

  • USB Auto-Sync: Plug in any USB drive with "Video," "Pictures," or "Music" folders, and the server automatically triggers an rsync to internal storage.
  • Midnight Optimization Engine: A scheduled task runs every night at 00:00 to scan for new MKV files. It automatically remuxes them into web-native MP4 containers, ensuring 100% compatibility for browser playback the next day without taxing the CPU during peak viewing hours.
  • Nightly Rotational Sync: Can be configured to "pull" only the last X months of media from a primary NAS, keeping your mobile library fresh without hitting SD card limits.

4. Networking & Resilience

  • Dual-Interface Gateway: Operates as a permanent Wireless Access Point while routing internet traffic through the physical Ethernet port. All services (DLNA, Samba, Cockpit) are bound to both interfaces, ensuring your media is accessible whether you are on the private WiFi bubble or the wired backbone.
  • Cockpit Management: Full web-based administration. Manage the terminal, file system, and services without ever opening an SSH client.
  • Stateless Recovery: One-command rebuild. If an SD card fails, the installer will download and setup in minutes.
    upgrading can keep all of your settings without overwriting if already configured.

    Demo video of the web server :-

  • 1 × Flirc case for Pi Zero 2 w A nice case to finish the project off
  • 1 × SanDisk 128GB Extreme PRO microSDXC card High performance SD card. dont cheap out. although the Kioxia Exceria Plus U3 is also a good card
  • 1 × Micro USB lead well you do want to power the device, right ?
  • 1 × SanDisk Ultra 256GB Dual Drive A USB and Micro USB pen drive to transfer your videos and music from a pc onto the PI but you can copy media across the network via samba to the Pi server
  • 1 × Micro Usb to Ethernet Lan Adapter With 3 USB Ports for Raspberry Pi Zero - White USB to Ethernet with 3x usb ports. Can be purchased from amazon for around £15

View all 6 components

  • Version 5.2 is now available

    diddy4 hours ago 0 comments

    Project Update: Enhanced Media Automation & Robust Transcoding

    The mkv-2-mp4.sh script, which runs as a scheduled midnight systemd task, has been overhauled to improve automation, reliability, and hardware efficiency. This script acts as the "cleanup crew" for the Mini Pi Media Server, ensuring all new downloads are standardized for DLNA streaming.

    Key Features of this Update:

    • Intelligent "Promotion" Phase: The script now automatically scans Transmission download subfolders. If a folder contains exactly one video file, it "promotes" it to the main library, deletes the leftover clutter (NFOs, samples, etc.), and removes the empty directory.
    • Power-Loss Protection: To prevent file corruption during a power failure, the script now uses a PROMOTING_ or CONVERTING_ prefix for temporary files. The final filename is only applied upon successful completion of the move or transcode.
    • Adaptive Hardware Encoding: It leverages the Raspberry Pi's hardware acceleration (h264_v4l2m2m). The script now calculates an adaptive bitrate—aiming for 70% of the source quality—to balance file size and visual fidelity dynamically.
    • Smart Fallback Logic: If the hardware encoder fails , busy or running on a Raspberry Pi 5, the script automatically falls back to a multi-threaded software encode (libx264) with a specialized mobile-friendly resolution (960x540) to ensure the task finishes.
    • Automated Library Maintenance: After processing, the script handles the "housekeeping" by resetting permissions for the minidlna user and restarting the service to trigger an immediate library re-index.

    Workflow Logic:

    1. Locking: Prevents multiple instances from running simultaneously.
    2. Stream Copying: If the source is already H.264/AAC, it copies the streams without re-encoding to preserve 100% quality and save CPU.
    3. Cleanup: Automatically deletes the original .mkv files only after a successful .mp4 conversion is verified.

    You can download / upgrade by running the following on the Raspberry Pi (either SSH into the Pi or on the actual Pi) :-

    wget -qO- https://raw.githubusercontent.com/diddy-boy/mini-pi-media-server/main/install.sh | bash

  • Mini-Pi Media server in the car

    diddy04/07/2026 at 18:21 0 comments

    Multiple streaming to two tablets in the car all from the Pi zero 2 w running from the cars electrics

  • Version 5.1 is now available

    diddy04/01/2026 at 22:43 0 comments

    Version 5.1 is out

    Fixes for displaying on mobile devices

    Fixed small bug with titlebar icon not displaying

    added a couple more background pictures that can be set.

    Added a recently viewed list to the file listing view based on previous use.

    You can download / upgrade by running the following on the Raspberry Pi (either SSH into the Pi or on the actual Pi) by copying :-

    wget -qO- https://raw.githubusercontent.com/diddy-boy/mini-pi-media-server/main/install.sh | bash

  • Quick FAQ

    diddy03/13/2026 at 08:31 0 comments

    Mini-Pi Media Server: Quick FAQ

    • Q: Which Raspberry Pi models are supported?
      • A: It is highly optimized for the Pi Zero 2 W (£14), but fully supports Pi 3, 4, and 5.
    • Q: Can I use an external hard drive?
      • A: Yes but only to synchronise from! The project includes an Auto-USB sync feature. Plug in a drive with "Video", "Music", or "Pictures" folders, and it will automatically sync media into the pi's media library.
    • Q: Does it support 4K?
      • A: The Zero 2 W handles 1080p HD effortlessly (up to 4 streams). For 4K, we recommend using a Pi 4 or 5 with an Ethernet connection. Streaming over wifi at this bandwidth is just asking for pain.
    •  Q: Do I need to be a Linux expert to install it?
      • A: No. It’s a one-command install. Just run the script from our GitHub and it handles the entire stack setup for you.
    • Q: How do I manage the server?
      • A: It comes with Cockpit Web Admin pre-installed. You can manage files, check system health, and terminal into the Pi directly from your web browser—no SSH knowledge required.

  • Beating the Pi Price Hike: Why 512MB is all you need for HD Streaming

    diddy03/13/2026 at 08:11 0 comments

    With the recent news of a second price spike for high-RAM Raspberry Pi models, many makers are feeling priced out of the home server hobby. If you’re looking at a £100+ price tag for a Pi 5 just to stream some movies, I have some good news: You're overspending.

    I captured this screenshot from the Mini-Pi's Cockpit dashboard during a stress test.

    The Setup:

    • Hardware: Raspberry Pi Zero 2 W (£14).
    • Load: 4 separate devices (Tablets/Phones) all streaming different HD content simultaneously.
    • The Result: Look at those metrics!

    The Proof is in the Data:

    • CPU Load: A staggering 0.01 average. The quad-core 64-bit chip in the Zero 2 W isn't even breaking a sweat.
    • Memory: Despite having "only" 512MB of RAM, the system still has 232MB available. My software stack is tuned to ensure the OS doesn't bloat, leaving plenty of room for MiniDLNA and Samba to do their jobs.
    • Temperature: Running cool at 38°C in a Flirc case—no expensive active cooling or massive heatsinks required.

    Stop Paying the "AI Tax"

    The price hikes on the Pi 4 and 5 are driven by global demand for high-density LPDDR4 RAM used in AI. But a media server doesn't need 8GB of RAM to move packets of video data.

    Mini-Pi proves that with the right software optimization, the £14 Zero 2 W is still the undisputed Budget King of home media.

    Don't upgrade your hardware—optimize your software.

  • Architecture Diagram layout

    diddy03/07/2026 at 10:57 0 comments

  • Mini Pi Media Server: Version 5 is Here!

    diddy03/06/2026 at 22:27 0 comments

    Version 5 introduces a major overhaul with a focus on a cleaner UI, better performance, and expanded features.

    What’s New?

    • Fresh Branding: A new "Pi-Play" logo now serves as the default background for new browser visits.
    • Refined UI:
      • Smoother Transitions: Polished animations when changing backgrounds.
      • Reduced Bloat: Optimized index.html for faster loading.
      • Stealth Mode: Click the branding logo to toggle the visibility of the "Easy Connect," "Select Background," and "System Status" buttons for a minimalist look.
    • Integrated Torrent Downloader: A built-in way to manage downloads directly from the dashboard.
    • Improved Installer: Optimized scripts for seamless version upgrades.

    How to Use the Torrent Downloader

    1. Navigate to Downloads on your dashboard.
    2. Login: Use username pi and password pi.
    3. Add Torrents: Click the Add Folder icon on the left, paste your magnet/torrent link, and you're set.
    4. Automation: The system downloads in the background (you can close the tab) and automatically saves files to your Video folder.
    Pro Tip: To organize your library, select Manage Server to enter Cockpit. Use the Navigator to browse to /var/lib/minidlna/Video to rename or move files. The Media Scraper runs daily at 5:00 AM to fetch metadata for your new content.

    Disclaimer: This tool is intended for legitimate use cases. The developer is not liable for how users choose to utilize this software.

    Download or Upgrade Now

    Run the following command in your terminal (via SSH or directly on the Pi) to launch the installer:

    wget -qO- https://raw.githubusercontent.com/diddy-boy/mini-pi-media-server/main/install.sh | bash

  • Mini-Pi Media Server v5.0 – UI Overhaul in Progress

    diddy03/04/2026 at 11:14 0 comments

    Mini-Pi Media Server v5.0 – A Complete UI Overhaul

    Version 5.0 marks a major milestone for the Mini-Pi Media Server project. This isn’t just another incremental update — it’s a full visual and user-experience redesign aimed at making the system feel less like a collection of scripts and more like a polished media appliance.

    The new interface introduces smooth focus and fade transitions inspired by modern living-room media platforms, giving the home screen a clean, cinematic feel. Navigation between Media, Torrent Downloader, and Web Server management now flows with subtle animations rather than hard page switches.

    Background customization has also been upgraded with seamless cross-fade transitions, replacing abrupt image changes with a more refined visual experience.

    System feedback has been reimagined as well. Status popups now use a glass-style aesthetic, and the system load indicator LED has been enhanced to pulse and change colour dynamically based on real-time CPU usage — turning raw metrics into ambient visual feedback.

    To keep the interface clean, secondary controls such as “Select Background” and “Easy Connect” are now tucked behind the branded icon, creating a simplified front page while still keeping advanced features easily accessible.

    In addition to the UI redesign, Version 5.0 integrates a built-in torrent downloader that writes directly to the MiniDLNA video directory. Newly downloaded content becomes instantly available to the DLNA server, Samba shares, and the Apache web interface — creating a seamless download-to-stream pipeline.

    Version 5.0 represents a shift in philosophy for the project: from functional media server to refined, self-contained media appliance.

    More screenshots and details coming soon.

  • version bump to 4.72

    diddy02/26/2026 at 09:34 0 comments

    Just a small update to version 4.72

    Fixed a small logic bomb in the version.txt that wasn't being written correctly to the apache web directory on install / upgrade. Result was that every user was notified of an update which they were already on.

    this has also given me the chance to set the 'Easy Connect' button size and spacing correctly on the main page

    You can download / upgrade by running the following on the Raspberry Pi (either SSH into the Pi or on the actual Pi) :-

    wget -qO- https://raw.githubusercontent.com/diddy-boy/mini-pi-media-server/main/install.sh | bash

  • Version 4.7 is out and its a big update

    diddy02/24/2026 at 20:47 0 comments

    Version 4.7 is now available with the following :-

    Fixed popup for USB syncing (the backend was working and Rsyncing data)

    Now comes with 'Easy Connect' Technology..... well actually just QR code generation for connecting to the Pi WIFI Access point via camera on a mobile device or tablet.

    Added an Upload button for Music, Video OR Pictures folder. Only upload supported file types.

    Version update check once a week, users will be notified on the main web page if there is a newer version with a link this this hackaday page for future instructions.

    Also added a zoom in view on page opening and fade out when selecting to View Media Files or Manage Server

    You can download / upgrade by running the following on the Raspberry Pi (either SSH into the Pi or on the actual Pi) :-

    wget -qO- https://raw.githubusercontent.com/diddy-boy/mini-pi-media-server/main/install.sh | bash

View all 45 project logs

  • 1
    how to setup / update

    Instructions to set up :-

    do the usual raspberry pi imager stuff and set the settings with a name of mini-pi (ideally this name).

    set the wifi to your wifi (and password) and set the user as pi and set to use ssh services.

    Then write the image

    once done place the SD card / USB pen driver into the pi, power up the pi and log into your router to find the mini-pi ip address (or use a network tool like fing or angry ip scanner).

    SSH into the raspberry pi (using ssh pi@<THE IP ADDRESS OF THE PI>

    once logged into the Raspberry Pi, run this single command that downloads, unzips and installs the media server software all in one command by :-

     

    wget -qO- https://raw.githubusercontent.com/diddy-boy/mini-pi-media-server/main/install.sh | bash

    This will then run the installer which pulls down the most recent build which unzip's and run's the setup / configuration.

    you will be prompted for a samba user password (its easy to use the same password as your ssh login).

    you can select to :-

    Configure WiFi as an access point (if you run this then an ethernet connection has to be used to stream at home).

    you can at any time in the future, run ./reconfigure-wifi.sh from within the mini-pi directory.

    Configure Cloud syncing (Using either Google Drive, One Drive or MEGA)

    you can at any time in the future, rcploe-setup.sh from within the mini-pi directory.

    Configure syncing from a server every night

    then you can press enter to reboot.

    All setup now. have fun.

    if you are updating, its similar.

    just ssh into the raspberry pi and run the above command to download and install again or if you just want to reinstall run 'sudo ./pi-setup/mini-pi-setup.sh'

View all instructions

Enjoy this project?

Share

Discussions

diddy wrote 02/04/2026 at 11:19 point

Version v4.3 contains a fix for the Pi 5's Wi-Fi and its known firmware issues with Trixie. If anyone is testing this on Trixie, let me know if it's working for you also

  Are you sure? yes | no

Similar Projects

Does this project spark your interest?

Become a member to follow this project and never miss any updates