Mediaplayer for Raspberry Pi

Mπ4 is a simple, very configurable media player for Raspberry Pi (3b+ and up). Designed for easy-to-use video playback in art installation. Heavily inspired by MP4MUSEUM by Julius Schmiedel.


Download

**** mpi4_v1beta2.img.xz ****

***CHANGELOG***
6/7/26 | v1beta2 - fixed composite output on Pi 4 & 5
3/7/26 | v1beta - initial release


SHA256: 9582da6f9e32a261ebb9efc80b2b0b9eae756bdad3e521fbfdb02fe4e69ec15c
MD5: 3d76f1c749c82cfe988a53dc06c0888c

Please note, this is in beta. There might still be some bugs. If you find any, please get in touch!

The images can be written to a microSD card (8GB +) with the Raspberry Pi Imager



Features

- Media playback form USB.
- Hot-swap USB media.
- Custom settings via settings file.
- Seamless looping playback of Video, Audio and Images.
- Synced playback with multiple players.
- HDMI or Composite video output.
- HDMI or Headphone audio output.
- Automatic resolution scaling.
- Support for external trigger buttons via GPIO.
- Easy Video Wall functionality
- Supported Video Types: .mp4 .mkv .avi .mov .m4v .webm
- Supported Image Types: .jpg .jpeg .png .bmp .webp
- Supported Audio Types: .mp3, .wav


Customize

Player Mode: Standalone | Sync Leader | Sync Follower
Audio Output: Headphones | HDMI
Image Hold Time
Video Rotation
Autoplay
GPIO Button Assignments
Video Wall Configuration
Advanced Sync Settings

All settings can be customized by placing a file called settings.mpi4 on the same usb drive as the media. This file can be generated in the Mπ4 Settings Generator


Hardware support

Mπ4 is fully supported on:
→ Raspberry Pi 5
→ Raspberry Pi 4
→ Raspberry Pi 3b+

Older devices:
→ Raspberry Pi 3b (non plus) will only work without full hardware acceleration which makes it only suitable when the media matches the native resolution of the display and no video wall or rotation is applied.
→ Raspberry Pi 1 and 2 are not supported by this software. Looking for a great alternative? MP4MUSEUM fully supports Raspberry Pi 4 and below with hardware accelerated video.


Licenses & Credits

Base: Raspberry Pi OS 13 (Trixie), 64-bit
Media Playback: mpv v0.40.0-3+deb13u1, licensed GPLv2+
GPIO Handling: gpiozero, licensed BSD 3-Clause
USB Auto-mounting: USBmount by Rogério Brito
Inspiration: MP4MUSEUM by Julius Schmiedel.

Mπ4 is built on top of, and distributes, the above open-source projects unmodified. Full source for each is available at the links above.

Mπ4 is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License, version 3, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License, version 3, is included with this distribution, and can also be found at https://www.gnu.org/licenses/gpl-3.0.html