First time posting! I just finished setting up Pico-8 on my Raspberry Pi Zero WH. Took me a long time but I want to pass on my experience incase someone else wants to try this.

I wanted to have a portable console, so I bought the Game Pi 20 (GAMEPI20) case to use as my initial build. (because it was cheap and I am still tinkering with this system).

I chose Retropie because it's an app running on top of Raspbian Lite, and I wanted to keep using this as a functional terminal-based computer when not gaming.

1. First off, I flashed the image for Retropie 4.7.1 found here to a 16gb SD card:

https://www.waveshare.com/wiki/GamePi20#Hardware_connection

2. Then I followed the hardware instructions here:

https://www.waveshare.com/wiki/GamePi20_Assembly

3. I followed the tutorial at this youtube link to get retropie set up with Pico-8, but read my step 4 before you watch it:

https://www.youtube.com/watch?v=lEECUe_t51o

4. The Controller:

4.1 In the video, the creator doesn't make it very clear, but the -SPLORE.sh file should be put in the ROMS folder for the pico-8.

4.2 The file he supplies, "sdl_controllers.txt" ,will not work with the GAMEPI20. I had to make my own. Here is how you do it:

4.3 Make a file called "sdl_controllers.txt" and paste the following code into it:

15000000010000000500000000010000,GPIO Controller 1,platform:Linux,a:b7,b:b1,x:b4,y:b0,back:-a1,start:+a1,leftshoulder:b3,rightshoulder:b6,dpup:-a0,dpdown:b11,dpleft:b10,dpright:+a0,

Save, then exit.

5. place this file you just made into the pico-8 directory instead of the one supplied in the youtube video. Then watch the rest of the video to get everything running.

6. I switched my theme to Super Retro Boy because it looks nicer on the tiny screen.

7. Enjoy! It took me a long time to figure out how to map the buttons. I hope I save someone my headache!