Pixelcade for MiSTer Install Guide

Pixelcade for MiSTer Beta

IMPORTANT: You must upgrade to the latest MiSTer before installing Pixelcade.

You’ll need at least 1 GB free on your SD card for the Pixelcade LED installation. The Pixelcade LCD installation will only take up 10 MB of disk space.

From a computer on the same network (Ethernet or WiFi) as your MiSTer, SSH into your MiSTer using the username of root and the password of 1.

Then issue the respective command for Pixelcade LED or Pixelcade LCD.

Pixelcade LED

curl -kLO pixelcade.org/mistersetup/setup.sh && chmod +x setup.sh && ./setup.sh

or

Pixelcade LCD

curl -kLO -H "Cache-Control: no-cache" https://raw.githubusercontent.com/alinke/pixelcade-linux/main/installer-scripts/setup-mister-lcd.sh && chmod +x setup-mister-lcd.sh && ./setup-mister-lcd.sh

Note in the command line -kLO is the letter O and not the number 0

The installation script will take around 30 minutes to complete for LED and just a few seconds for LCD.

After the installation has finished, reboot your MiSTer and then your Pixelcade should be changing dynamically as you browse and launch games from the MiSTer Front End.

If Pixelcade is NOT changing, then SSH back into your MiSTer and run this command manually to see what is happening.

cd /media/fat/pixelcade/ && ./runpixelcade.sh

Shortly after MiSTer has booted, Pixelcade LED should go blank. If it is not changing after that, then open this file

/media/fat/MiSTer.ini

And ensure that this line is present in the file (the installer script should have added this line automatically):

log_file_entry=1

For reference, Pixelcade has been tested on MiSTer V220413 and V210906

For LCD specifically,  you may need to run the above command repeatedly until you see that IP address has been detected.

For LCD for MiSTer, you must also disable scrolling text. Scrolling text can be disabled using this URL from any browser on the same network as your MiSTer. 

http://pixelcadedx-xxxxxxxx.local/settings?key=SubDisplayScrollingOnly&value=yes

where xxxxxxxx is the unique ID of your Pixelcade LCD

Pixelcade LCD Artwork Updater

curl -kLO -H "Cache-Control: no-cache" https://raw.githubusercontent.com/alinke/pixelcade-linux-builds/main/lcdupdater/lcdupdater.sh && chmod +x lcdupdater.sh && ./lcdupdater.sh

Browsing Artwork and Customizing the Default Image/Animation from a Web Browser (For LED Only)

There is also a Web UI to browse artwork and customize the default image or animation on Pixelcade.

  • Saving will write the selected image or animation to Pixelcade’s onboard microSD card and the last written image or animation will loop and continue to play before MiSTer startup and after MiSTer exit.

IMPORTANT: After clicking save, Pixelcade will go blank do not click or do anything else until the image or animation re-appears on Pixelcade. Longer animations will take longer to save.

  • From your web browser, go to

<Your MiSTer IP Address>:8080/files/index.html

For example: 192.168.1.198:8080/files/index.html

As long as you can reach your MiSTer on your network, you can reach this page from any computer on your network.