HowTo Hack

On the current version, start by booting the player with no media to play, and a usb keyboard attatched- Any Video playing would be in foreground, hiding the text. After the startup video, the screen will be blank.

To get to the login screen, press Alt + F2 to switch to console number 2. It might take a second for the console text to appear. When prompted, login with user “pi” and password “mp4museum”. Continue below to learn how to make changes to the system.

Acces via Network

Get started with a Raspi with ethernet or WiFi, and connect it to your network, so you can easily login via ssh to make changes to the script, other files or the system in general:

User pi, password mp4museum, find your IP with this guide from

Windows SSH Client: Download PuTTy

Mac: Use the Terminal App and type ssh pi@(add IP here, or try “mp4musem.local” instead of IP)

Many commands involve sudo to get admin access, so be careful. Or not, you can always re-write the standard image 😉 There is no such thing as failure, just call it “iterative design”.

Remount for Write Access

After logging in, start by remounting the filesystem for write access.

sudo mount -o remount,rw /

Replace the path / with /media/video if you would like to change the loop file on mp4musem-sync.

The same goes for /boot/, where you would find config.txt, or add alsa.txt to route audio.

Edit the main script

With Nano, you get a basic text editor in the console. For example, use


to open the main script file. It contains event handlers for button functionality, it is playing the startup logo film, and runs the main loop indexing and playing from USB.

After your changes are done, press “CTRL + X” to exit, and answer “y” to save the content of the editor to the file.

Note: On mp4m-sync, the player is started as a service, there is no script.

Reboot the machine

sudo reboot

to see if your changes are successful. Please not that this will put the card back into read-only mode.

Last but not least, find additional resources on GitHub