Media Player 4 Museum

A minimalistic, Open Source Video Player.
Used by Museums and Artists (and Companies) worldwide.

Loops all MP4 Files from USB Memory.
No nonsense!

  • Supports multiple sticks, using FAT, ExFAT, NTFS, HFS
  • Skip Files with a switch
  • Pause Playback with a switch
  • Player will boot up within 30 seconds
  • Video files are sorted A..Z
  • System is read-only, no shut down
  • Will work perfectly 24/7 or on a timer switch


V5 Beta for 4k on Raspi4!

Check out the mp4museum-v5 beta (1,3gb)!
It now runs on VLC, so it plays all of your favorite media- mp4, mp3, mkv, wav, jpg ... and more.
Please send feedback to julius at ;)
Test 4k when you can, that would help the most!


Installation in 4 simple steps:

  1. Download the Image below...
  2. Clone Image to a Card for Raspberry Pi (howto)
  3. Attach USB Memory Stick with .mp4 files
  4. Connect to screen and power supply


Version 4.20 of july 6, 2020 ISO Image in ZIP
(948MB, IMG MD5 Checksum 8595aba23b300722ede1487bb7a6847d)
 ✓ Tested on Pi 4, Pi 3A+, Zero (supports all Raspi)

Version 4 of may 6, 2019 ISO Image in ZIP
(607MB MD5 Checksum c58007dec7ffb0e031f9dfac9fa2f550)
 ✓ Tested on Pi 3+, A+ (old model), Zero

Version 3 beta of august 23, 2018 ISO Image in ZIP
(575MB, image MD5 Checksum 63e7619d6fb983b884234b1ceb8e3b73)
 ✓ Tested on Pi 1, 3+, A+, Zero

Version 2 of may 26, 2017 ISO Image in ZIP
(506MB, MD5 Checksum 22489c0ea4e559a48ee4e4158663f9e2)
 ✓ Tested on Pi 2, 3, A+, ZeroW

Version 1 of november 18, 2016 ISO Image in ZIP
(684MB, MD5 Checksum faba1905352d7db74c5a3da139b5b221)
 ✓ Tested on Pi 2, 3, Zero, A+


You like?

Consider donating to the projects author, in espresso coffee powder or money ;) I am also happy to recieve code snipptes, in case you modified the software.


3D Print Enclosure

Updated Nov 2019, this will fit a Pi 3 A+, my current favorite pi, as seen in the picture above.

  1. Download zipped STL files
  2. Print nicely
  3. Mount Pi with 4x M3 10mm


Check out the HowTo to get the most of MP4MUSEUM



Where's the magic? How does it work?
After booting up, it will run the script from the pi home directory.

How do I login?
Connected to a Network providing DHCP, you can use SSH, User pi, Password mp4museum

Would it play video files from SD Card?
It could, but the internal card is used read-only. If you know your linux, go hack it: RE-mount as RW, store media in home folder and change accordingly.

How do i connect those switches?
Add a regular (closing) switch between +5V and pin 11 or 13 for pause or skip. See it here.

Seamless Loop?
The hardware playback enginge doesn't support this. Better edit a file with your loop inside, so it skips less often.  

Problems & possible solutions

USB Stick Format: Use a Flash Drive, and not a Harddisc. FAT32, HFS, NTFS, ExFAT supported.

Check the LED's: Red steady = Power Good, Green flickering = Booting / Working, Green steady = Boot Issue / SD Card Problem

No sound or image on hdmi? Check this out to learn about setting up config.txt.

AV Check (V3 and later) During logo playback you should hear a film projector sound. Also, there are thin orange lines in all four corners- if you cannot see them, check your overscan settings.

Hardware Problems: Needs good power: Original Raspi, maybe Apple iPad Charger. HDMI output is not very capable, stick to one cable between Pi and Screen/Projector, also, keep it short.

White/Green Screen at the end of Video - This could happen if the omxplayer app has problems with reading your file. Try to encode your .mp4 using a hight-quality preset in handbrake.



Julius Schmiedel is a media artist from cologne.

Please send your feedback to julius©urgu⋅de
Let me know about problems, solutions, back padding.

Open Case of MP4MUSEUM showing the raspberry pi inside

System Based on Raspbian Lite and OMXPlayer
Enclosure is a remix of this thing.
Last Update: july 7th, 2020