How to install PICO-8 on GameShell


I have the same problem – zip file right off Lexaloffle into that directory… doesn’t show up. Where should it appear? At the home menu? I rebooted, tried LauncherGo instead… reloaded UI… all nothing…

Also, maybe dumb question, but do you have to unzip it, or will the GameShell handle a zip like a directory?


I’m also having issues where the app can’t load (always crashes, goes to main menu). I followed parts of this walkthrough, then realized the zip inside PICO-8 should work, and now I’m uncertain what elements could be causing this issue from either operations.

I’ve been going through the SSH command line and have edited some of the common files that are being brought up in this thread. Below are the contents.

Files within the ‘launcher/Menu/GameShell’ directory

~/launcher/Menu/GameShell/50_PICO-8/pico-8/ ls
config.txt log.txt sdl_controllers.txt


// :: Video Settings
window_size = 320 240
screen_size = 320 240


cd /home/cpi/games/PICO-8/pico-8
SDL_VIDEODRIVER=xll DISPLAY=:0 ./pico8_dyn =splore -draw-rect 32,0,256,240

Within the PICO-8 folder in ‘games’

~/games/PICO-8/ ls
15133.p8.png  pico-8

~/games/PICO-8/pico-8/ ls
lexaloffle-pico8.png  license.txt  pico8  pico8.dat  pico8_dyn  pico8.txt

It would be helpful if the instructions could explain why we do certain operations rather than only what since it makes troubleshooting much harder. For instance, no tutorial mentions where exactly the pico-8 folder and contents are supposed to live.

EDIT: the user @hpcodecraft provided some information in another thread that resolved my issue:

I had the same issue and solved it like this:

The launcher script for pico-8 contains this line
cd /home/cpi/games/PICO-8/pico-8

From there it tries to launch the actual pico8 binary. So all I had to do was to unzip the pico-8 archive (again - I had it running before and have no idea why it vanished):

cd ~/games/PICO-8

This created the pico-8 folder the launcher wants and voila, it runs again.

Additional tip: If you link your carts folder to ~/games/PICO-8 , you can upload carts via WinSCP or the file browser. To do that, run this command: ln -s ~/.lexaloffle/pico-8/carts/ ~/games/PICO-8/carts

Hope that helps!


Hi all, I don’t know what I’m doing wrong, but I followed this guide all the way till this step, and when I click on the PICO-8 icon, It still tells me that I have purchase the PICO-8 although I already did, it’s driving me crazy…

Someone pls help me… =(

1 Like


I’ve been trying to upload some carts onto my GameShell, and this directory doesn’t seem to exist in my device:

I was wondering if you would have any idea of what other directory I would have to upload my carts to.



Did you put the raspberry pi zip file in the games/PICO-8 folder?


The directory exists. It’s just not normally visible since its name starts with a period. SSH into the GameShell and enter the following:

cd ~/.lexaloffle/pico-8/carts



You are trying to install the newest version of PICO8.
Try to update launcher and check If you have your versions of PICO8 inside this file or just replace that file with versions from GitHub


Open compkginfo.json in any text editor and replace content with that:

"NotFoundMsg":["Please purchase the PICO-8 \n|None|varela16",
"and copy it to the \"~/games/PICO-8\"|None|varela16"],
"MD5":{"":"a3f2995cf117499f880bd964d6a0e1f2","":"6726141c784afd4a41be6b7414c1b932","":"08eda95570e63089a2b9f5531503431e","":"1a62b0d7d4e4be65f89f23ec9757cb66","":"whatever it takes"},

The problem could be that your file doesn’t contain line with


Yes. I kinda figured it out by myself but thank you so much for replying.


Thank you for the walk through! I got PICO8 up and running, start and select are working, but ABXY are not. Rebooting the Gameshell doesn’t seem to fix anything. Any thoughts?