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 fetches your specific configs from GitHub and restores the entire environment in minutes.

    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

  • 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

  • Version 4.6 has just dropped

    diddy02/20/2026 at 20:11 0 comments

    Version 4.6 is now available with the following changes :-

    Updated the media scraper so that movie description AND plot is now downloaded to a limit of 600 words per movie.

    The previous intelligence of stripping out the movie 'Plot' was temperamental on some films.

    This new method is more reliable

    Added a tooltip for keyboard controls

    Added system status popup of main services - Green, all running, Red service not running

    Updated the resume a previously watched media file, instead of a browser popup, this message is now inline with the movie playing window and in the correct theme

    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.5 is now available

    diddy02/13/2026 at 20:32 0 comments

    Version 4.5 adds the following :-

    Search Bar : for searching media in the current directory and directories below

    Universal Cloud Integration:  expanded the "Cloud Sync" capabilities from just Google Drive to include OneDrive and MEGA, making the project accessible to a much wider audience. Just use one type when selecting during the install.

    SVG Icon Graphics for Media types

    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

  • Pi zero 2 w running powerbank use

    diddy02/10/2026 at 10:48 0 comments

    Since the Pi zero 2 w can be powered off a power bank.

    A 20,000 mah power bank easily gives over 24 Hours of use !

    Only drawing 1 watt of power with everything booted up and idle and that's with the usb to etherent adapter connected as well.

    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 42 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