# How to install PICO-8 on GameShell **URL:** \ **Category:** Tutorials\ **Tags:** pico-8\ **Created:** [July 29, 2018, 4:25pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012 "2018-07-29T16:25:17Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![skywalker101](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/skywalker101/32/132_2.png) [@skywalker101](https://forum.clockworkpi.com/u/skywalker101)\ **Post date:** [July 29, 2018, 4:25pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/1 "2018-07-29T16:25:17Z")
**Last updated: June 2019** _ **Originally written by @dddaaannn** _ _**Source: [https://github.com/clockworkpi/GameShellDocs/wiki/Running-PICO-8-on-the-GameShell](https://github.com/clockworkpi/GameShellDocs/wiki/Running-PICO-8-on-the-GameShell)**_ PICO-8 is a fantasy console for making, playing, and sharing small games. PICO-8 is a commercial product by Lexaloffle Games LLP. Versions are available for Windows, mac OS, Linux, and Raspberry Pi. The Raspberry Pi version runs on the GameShell, with some set-up. As of Launcher v1.24, the Launcher now has a built-in PICO-8 installer to make this even easier! You will copy PICO-8 to your GameShell, then run this installer to finish set-up. Follow these instructions to get PICO-8 and install it on your GameShell. It will run in the _splore_ mode, which lets you browse, download, and play PICO-8 games. **Updating the Launcher** If you haven’t already, connect your GameShell to wifi, and perform a software update. You can do both of these under Settings. Locate the “Wi-Fi” and “Update” options, and use them to update to at least Launcher version 1.24. You should see a PICO-8 option in the main menu. You will use this to install PICO-8. _Note:_ Launcher v1.24 also includes an alternate Launcher called “LauncherGo.” Only the original Launcher has the PICO-8 installer. Switch back to Launcher, if necessary. **Purchasing PICO-8** Go here to purchase your copy of PICO-8 if you don’t already own it: [https://www.lexaloffle.com/pico-8.php#getpico8](https://www.lexaloffle.com/pico-8.php#getpico8) ($15) Once purchased, visit the downloads page and download the Raspberry Pi version. This file has a filename similar to: `pico-8_0.1.12c_raspi.zip` _Tip:_ Your PICO-8 license includes versions for all platforms. Download the version for your desktop computer, make PICO-8 games of your own, and run them on your GameShell! **IMPORTANT: Renaming the file so the installer can find it** As of Launcher v1.24, the installer is expecting PICO-8 version 0.1.11g. It works with the latest version, but for now you have to work around this expectation. Rename the file from `pico-8_0.1.12c_raspi.zip` to `pico-8_0.1.11g_raspi.zip`. You can do this from your computer’s file explorer, or from the Mac or Linux command line: ```auto mv pico-8_0.1.12c_raspi.zip pico-8_0.1.11g_raspi.zip ``` **Transfering PICO-8 to the GameShell** The Launcher’s PICO-8 installer looks for the zip file in a folder (directory) with this path: `~/games/PICO-8/` (The `~` means the `cpi` user’s “home” directory, containing the `games` directory where you put various game ROMs and such. The `PICO-8` directory is inside there.) Connect your GameShell to your wifi network and get its IP address: 1. Turn on your GameShell. 2. If necessary, connect the GameShell to your wireless network: Settings, Wi-Fi. 3. In the main launcher menu, select TinyCloud. This displays the IP address of your GameShell, such as `192.168.0.49`. You can transfer files to the GameShell using `scp`, a file transfer method based on `ssh` (Secure Shell). Some file transfer programs know how to do this, such as Putty SCP for Windows, WinSCP for Windows, or Transmit for Mac. Connect using the IP address, an account name of `cpi`, and a password of `cpi`. On Mac and Linux (and also Windows with Putty SCP or the Windows Subsystem for Linux), you can use a Terminal to do this with a command-line interface and the scp command. To transfer PICO-8 to the `~/games/PICO-8` directory on the GameShell using the scp command: ```auto scp pico-8_0.1.11g_raspi.zip cpi@192.168.0.49:~/games/PICO-8/ ``` Enter the password `cpi` when prompted. **Running the Launcher’s PICO-8 installer** On your GameShell, use the Launcher to navigate to the PICO-8 icon, then select it. If this displays instructions to copy PICO-8 to `~/games/PICO-8`, then it didn’t find the file. Review the instructions above, and make sure the file is named `pico-8_0.1.11g_raspi.zip` even if you downloaded a newer version. If this displays the “MD5 error,” then **it’s working!** It is displaying this error because it expected to find PICO-8 version 0.1.11g, but you provided the newer version. Tell it to continue anyway. **Welcome to PICO-8!** After it installs, PICO-8 starts in _splore_ mode. From now on, the PICO-8 option in the Launcher will just launch PICO-8 like this. Move right to find the “Featured” section. If necessary, press B on [update] to load the list. Move up and down to find a game, then press B to start it. PICO-8 games use one or both of the A and B buttons. Some games will refer to these as Z and X, or C and V, because these are the default keys on a desktop computer. Games may also refer to them as (O) and (X), which are their “fantasy console” button icons. To exit a game and return to the Splore game selection menu, press the GameShell MENU button, then select “Exit to Splore”. (You can also use the pause menu just to pause your game.) To exit PICO-8 entirely and return to the GameShell Launcher, exit to Splore, then press MENU again and select “Shutdown PICO-8”. _Tip:_ Be careful not to select “Exit to Console” from the shutdown menu. This puts PICO-8 in its game developer mode. It’s a super fun mode, but you need a full keyboard to use it or get back out of it. Hold down the GameShell’s power button to reset if you get stuck here. Enjoy the games, and come visit the PICO-8 community in the forum to learn more! Resources: - [The PICO-8 website](https://www.lexaloffle.com/pico-8.php) - [The PICO-8 forum (“BBS”, where games are published)](https://www.lexaloffle.com/bbs/?cat=7) - [Lazy Devs video of this installation procedure](https://www.youtube.com/watch?v=ltBVKFw88zw), including the v1.24 file renaming workaround - [Lazy Devs video of additional steps](https://www.youtube.com/watch?v=4veRSqVHzoI) to enable volume buttons and upload PICO-8 cart files directly to the GameShell ---
**Author:** ![dddaaannn](https://avatars.discourse-cdn.com/v4/letter/d/a183cd/32.png) [@dddaaannn](https://forum.clockworkpi.com/u/dddaaannn)\ **Post date:** [July 29, 2018, 6:11pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/2 "2018-07-29T18:11:23Z")
I don’t object to reposting the tutorial to the forum. [Update: The original post has been edited to remove the offending content.] I strongly object to adding the insinuation that the reader should pirate PICO-8. I explicitly wrote that section to discourage piracy. Please remove this, or remove the post. I realize that we’re playing a bit loose with copyright on old game ROMs for emulators. PICO-8 is not in the same category: it’s inexpensive commercial software being developed actively by a small software company. Pirating PICO-8 is not the same as sharing old abandoned ROMs. Pirating PICO-8 actively hurts everyone who supports it. If you like PICO-8, pay for it. ---
**Author:** ![hal](https://avatars.discourse-cdn.com/v4/letter/h/ee7513/32.png) [@hal](https://forum.clockworkpi.com/u/hal)\ **Post date:** [July 29, 2018, 6:18pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/5 "2018-07-29T18:18:43Z")
---
**Author:** ![hal](https://avatars.discourse-cdn.com/v4/letter/h/ee7513/32.png) [@hal](https://forum.clockworkpi.com/u/hal)\ **Post date:** [July 29, 2018, 6:35pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/6 "2018-07-29T18:35:44Z")
Thank you both! PICO-8 is indeed a closed source, we respect it. It is obviously a GREAT project. We are also looking for some open source “fantasy computer” or we can DIY one 😌. ---
**Author:** ![Godzil](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/godzil/32/60_2.png) [@Godzil](https://forum.clockworkpi.com/u/Godzil)\ **Post date:** [July 29, 2018, 7:51pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/7 "2018-07-29T19:51:46Z")
Rerverted the first post with content, (as for @dddaaannn I don’t mind it to be here too, some people don’t go to the Wiki) and removed the flagged content (plus a little bit of reformatting) ---
**Author:** ![Godzil](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/godzil/32/60_2.png) [@Godzil](https://forum.clockworkpi.com/u/Godzil)\ **Post date:** [July 29, 2018, 7:51pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/8 "2018-07-29T19:51:55Z")
---
**Author:** ![nouty](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/nouty/32/4255_2.png) [@nouty](https://forum.clockworkpi.com/u/nouty)\ **Post date:** [July 30, 2018, 1:39pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/9 "2018-07-30T13:39:07Z")
Works like a charm! Thanks a lot. Was worth the 15 US-Dollars. ---
**Author:** ![ZELSK8](https://avatars.discourse-cdn.com/v4/letter/z/f07891/32.png) [@ZELSK8](https://forum.clockworkpi.com/u/ZELSK8)\ **Post date:** [July 30, 2018, 7:44pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/10 "2018-07-30T19:44:27Z")
PICO-8 won’t start for me from the launcher. I followed every step and have now the PICO-8 icon in my launcher. I even changed the icon to the PICO-8 logo but every time I want to start the program, it boots back into the launcher. The only way I can start PICO-8 is by entering this command via ssh: > ``` > echo >~/apps/launcher/Menu/GameShell/PICO-8.sh > SDL_VIDEODRIVER=x11 DISPLAY=:0 /home/cpi/pico-8/pico8_dyn -splore -draw_rect 32,0,256,240 > > ``` EDIT: I just discovered that the PICO-8.sh located in ~/apps/launcher/Menu/GameShell/ was completly empty. I just added the following line to connect the .sh file to the actual program: > ``` > SDL_VIDEODRIVER=x11 DISPLAY=:0 /home/cpi/pico-8/pico8_dyn -splore -draw_rect 32,0,256,240 > > ``` ---
**Author:** ![Michel\_Jones](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/michel_jones/32/439_2.png) [@Michel\_Jones](https://forum.clockworkpi.com/u/Michel_Jones)\ **Post date:** [July 30, 2018, 9:40pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/11 "2018-07-30T21:40:28Z")
Love it!! Well totally worth the money!! ---
**Author:** ![dddaaannn](https://avatars.discourse-cdn.com/v4/letter/d/a183cd/32.png) [@dddaaannn](https://forum.clockworkpi.com/u/dddaaannn)\ **Post date:** [July 31, 2018, 3:21am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/12 "2018-07-31T03:21:46Z")
@ZELSK8 Glad you got it working! It looks like the “echo” statement got split into two lines in this forum repost, which would have the effect you described. As one line, it creates that file with “SDL…” as its contents, which is the intended effect. As separate lines, it would create an empty file (the first line), then separately start PICO-8 (the second line). 🙂 The original doc has this correct. The error is only in this forum repost. Maybe someone with edit permissions can fix it? ---
**Author:** ![macario](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/macario/32/14564_2.png) [@macario](https://forum.clockworkpi.com/u/macario)\ **Post date:** [July 31, 2018, 9:03am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/13 "2018-07-31T09:03:54Z")
If you are enjoying PICO-8, don’t forget to lookup the #pico8 hashtag on Twitter. One of the liveliest programming-focused communities out there. ---
**Author:** ![Godzil](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/godzil/32/60_2.png) [@Godzil](https://forum.clockworkpi.com/u/Godzil)\ **Post date:** [July 31, 2018, 9:19am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/14 "2018-07-31T09:19:26Z")
and follow @lexaloffle on twitter too! ---
**Author:** ![Godzil](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/godzil/32/60_2.png) [@Godzil](https://forum.clockworkpi.com/u/Godzil)\ **Post date:** [July 31, 2018, 9:20am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/15 "2018-07-31T09:20:27Z")
I’ve set the first post as a “wiki”, so you should be able to edit it. ---
**Author:** ![Gryzor](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/gryzor/32/739_2.png) [@Gryzor](https://forum.clockworkpi.com/u/Gryzor)\ **Post date:** [August 2, 2018, 4:46pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/17 "2018-08-02T16:46:33Z")
Perhaps a n00b question, but after installing Pic8, how do you add games? ---
**Author:** ![macario](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/macario/32/14564_2.png) [@macario](https://forum.clockworkpi.com/u/macario)\ **Post date:** [August 2, 2018, 4:57pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/18 "2018-08-02T16:57:10Z")
@Gryzor: If you are connected to the internet, you should be able to access a selection of popular games in the FEATURED panel: ![image](https://canada1.discourse-cdn.com/flex029/uploads/clockworkpi/original/1X/d30122af74fcd34c23db23b9dca824074a26686e.png) plus all those available in the BBS ([https://www.lexaloffle.com/bbs](https://www.lexaloffle.com/bbs)) in the last one. You may need to select UPDATE in the menu for them to refresh. ---
**Author:** ![Gryzor](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/gryzor/32/739_2.png) [@Gryzor](https://forum.clockworkpi.com/u/Gryzor)\ **Post date:** [August 2, 2018, 4:59pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/19 "2018-08-02T16:59:49Z")
Ohh fantastic. I didn’t know because I’ve never used it! Going to buy it now… Thanks! ---
**Author:** ![Gryzor](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/gryzor/32/739_2.png) [@Gryzor](https://forum.clockworkpi.com/u/Gryzor)\ **Post date:** [August 2, 2018, 5:23pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/20 "2018-08-02T17:23:44Z")
Ok, bought and installed, great guide and a huge thanks 🙂 One more question - despite the reference to key input in the guide, I find that my YXAB keys don’t seem to do anything at all… how have people configured it? [EDIT] oooops I missed the “button\_keys 0 0 0 0 13 14 0 0 0 0 0 0 0” line…[/EDIT] Oh, also, does it auto update or something, or do I need to keep an eye out on updates and unzip them manually? Thanks again! ---
**Author:** ![follower46](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/follower46/32/414_2.png) [@follower46](https://forum.clockworkpi.com/u/follower46)\ **Post date:** [August 3, 2018, 4:28am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/21 "2018-08-03T04:28:59Z")
I’m not sure if anyone else will want this, but I wrote a small script to add volume controls to PICO-8. Here’s the code: [https://gist.github.com/follower46/69cdc41d9dc09cf9fe97b48ec4036158](https://gist.github.com/follower46/69cdc41d9dc09cf9fe97b48ec4036158) and a video of it running: [https://www.youtube.com/watch?v=BAoYapdMiPM](https://www.youtube.com/watch?v=BAoYapdMiPM) ---
**Author:** ![Gryzor](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/gryzor/32/739_2.png) [@Gryzor](https://forum.clockworkpi.com/u/Gryzor)\ **Post date:** [August 3, 2018, 4:46am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/22 "2018-08-03T04:46:56Z")
Ooh nice! Will it autorun or does the user have to execute each time? I don’t have a pico.sh in the pico-8 dir… [EDIT]…but, here it is: /home/cpi/apps/launcher/Menu/GameShell/PICO-8.sh [EDIT2] Hmm… followed the instructions to a t, but it doesn’t work… My PICO-8.sh reads: SDL\_VIDEODRIVER=x13 DISPLAY=:0 python /home/cpi/pico-8/pico-8-volume.py SDL\_VIDEODRIVER=x11 DISPLAY=:0 /home/cpi/pico-8/pico8\_dyn -splore -draw\_rect 32,0,256,240 Have installed pyxhook, pico-8-volume.py is in home/cpi/pico-8, but nothing happens with the vol keys. ---
**Author:** ![Godzil](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/godzil/32/60_2.png) [@Godzil](https://forum.clockworkpi.com/u/Godzil)\ **Post date:** [August 3, 2018, 10:36am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/23 "2018-08-03T10:36:06Z")
Not only a selection of popular, you can also see the most recent published in some category. The only thing that would not work at the moment is the search as it need a keyboard. [Next page](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012.md?page=2)