# How to install PICO-8 on GameShell

**URL:** https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012
**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:** 3

<div class="post-metadata">

### 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 15, 2018, 10:04am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/44 "2018-08-15T10:04:59Z")

</div>

Ah darn. Picked it up after a few days, I get the locking too. Mind you, it keeps running, but keys are unresponsive. You can actually see it if you launch a game fast enough - it keeps on running but keys don’t work.

---

<div class="post-metadata">

### Author: ![Micro007](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/micro007/32/745_2.png) [@Micro007](https://forum.clockworkpi.com/u/Micro007)
#### Post date: [August 16, 2018, 3:08am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/45 "2018-08-16T03:08:09Z")

</div>

This is just epic.

Best Pico-8 games  
AND GO

---

<div class="post-metadata">

### 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 16, 2018, 6:50am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/46 "2018-08-16T06:50:50Z")

</div>

> [@Micro007](#):
>
> Best Pico-8 games  
> AND GO

Come again now? _char limit_

---

<div class="post-metadata">

### Author: ![Micro007](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/micro007/32/745_2.png) [@Micro007](https://forum.clockworkpi.com/u/Micro007)
#### Post date: [August 16, 2018, 9:49pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/47 "2018-08-16T21:49:30Z")

</div>

Haha I mean like “what are the best games on Pico-8!”

AND GO! Lol

Has anyone found a perfect fullscreen res yet? I’m not around my computer so I can’t mess around

---

<div class="post-metadata">

### Author: ![dddaaannn](https://avatars.discourse-cdn.com/v4/letter/d/a183cd/32.png) [@dddaaannn](https://forum.clockworkpi.com/u/dddaaannn)
#### Post date: [August 17, 2018, 2:41am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/48 "2018-08-17T02:41:26Z")

</div>

This is a good list of Pico-8 games: [https://www.playpico.com/](https://www.playpico.com/)

(Forum thread about the list: [https://www.lexaloffle.com/bbs/?tid=27847](https://www.lexaloffle.com/bbs/?tid=27847))

The site doesn’t make it immediately obvious how to download each game for local play, but nearly every game has a link to the BBS thread where the author first posted the game. You can click “Cart” there to get the PNG file.

---

<div class="post-metadata">

### 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 17, 2018, 8:34am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/49 "2018-08-17T08:34:26Z")

</div>

Ah, that’s a great resource! Pity it doesn’t have an RSS feed…

---

<div class="post-metadata">

### Author: ![pokeylop](https://avatars.discourse-cdn.com/v4/letter/p/eb9ed0/32.png) [@pokeylop](https://forum.clockworkpi.com/u/pokeylop)
#### Post date: [August 31, 2018, 11:21am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/50 "2018-08-31T11:21:53Z")

</div>

Installed and launched Pico-8, but the config files aren’t being created when I do so. I’m also not getting the launch chime when I launch Pico-8. Anyone know how to fix this, or link me to a config directory I could copy? Thanks 😃

---

<div class="post-metadata">

### Author: ![demomonkey](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/demomonkey/32/1290_2.png) [@demomonkey](https://forum.clockworkpi.com/u/demomonkey)
#### Post date: [October 9, 2018, 1:59am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/51 "2018-10-09T01:59:17Z")

</div>

Thanks to everyone here. Another Pico-8 up and working on the GS.

Instructions were excellent. I ended up with broken links 'cause I was being fancy with the directories. I went back, slowed down, and it was easy to find where I went wrong. Thanks for the excellent work making this clear. Played for about 10min to check inputs, etc. Works great, no issues on my updated launcher system. I did have 1 game out of 10 crash on me, but I figured that was par.

PICO-8 is a sweet program I just discovered due to these forums, so I can’t wait to find the next cool thing to stumble onto with the GS. I’m hoping that Lexaloffle picks up GameShell where they left off with CHIP. Did someone say custom GS build? Yeah, it was me.

How about Voxatron? Wonder if GS could even run that thing…

---

<div class="post-metadata">

### Author: ![mirobane](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/mirobane/32/1423_2.png) [@mirobane](https://forum.clockworkpi.com/u/mirobane)
#### Post date: [December 22, 2018, 11:39pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/52 "2018-12-22T23:39:38Z")

</div>

heya!

this wont work on v0.21

im stuck without icon to select on menu.

after a little jump on fillezilla seems folder architecture have changed. for the rest im not enougth smart to understand how to do.

cheers.

---

<div class="post-metadata">

### Author: ![lasvegas](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/lasvegas/32/769_2.png) [@lasvegas](https://forum.clockworkpi.com/u/lasvegas)
#### Post date: [December 23, 2018, 4:21am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/53 "2018-12-23T04:21:12Z")

</div>

Place the icon file in the same folder with the launcher script. If they have the same name, they’ll work together.

---

<div class="post-metadata">

### Author: ![mirobane](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/mirobane/32/1423_2.png) [@mirobane](https://forum.clockworkpi.com/u/mirobane)
#### Post date: [December 23, 2018, 11:51am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/54 "2018-12-23T11:51:28Z")

</div>

found a way to correct it.

the good command for 0.21 are

> ```
> echo >~/launcher/Menu/GameShell/PICO-8.sh SDL_VIDEODRIVER=x11 DISPLAY=:0 /home/cpi/pico-8/pico8_dyn -splore -draw_rect 32,0,256,240
> 
> ```

i do it and i got my icon on menu.

custom icon are to put in

> /home/cpi/launcher/skin/default/Menu/GameShell

---

<div class="post-metadata">

### Author: ![guu](https://avatars.discourse-cdn.com/v4/letter/g/7ab992/32.png) [@guu](https://forum.clockworkpi.com/u/guu)
#### Post date: [December 23, 2018, 1:40pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/55 "2018-12-23T13:40:58Z")

</div>

a small PS

```auto
cpi@clockworkpi:~/apps/Menu/50_PICO-8$ ls
pico8 pico8.dat pico8_dyn PICO-8.png PICO-8.sh

```

in os v0.21 ,already installed wiringPI for pico-8

so like above ,create a folder with name of **50\_PICO-8** ← here the **50\_** is for the order in launcher ,but not necessarily  
**PICO-8.png** is the icon  
**PICO-8.sh** is where to start pico-8  
They all have the same name as the directory, but different extensions

from v0.2x, launcher can read items from ~/apps/Menu, doing so will facilitate future data migration , launcher switching

```auto
cpi@clockworkpi:~/apps/Menu/50_PICO-8$ cat PICO-8.sh 
#!/bin/bash

SDL_VIDEODRIVER=x11 DISPLAY=:0 ./pico8_dyn -splore -draw_rect 32,0,256,240

```

> chmod +x PICO-8.sh

---

<div class="post-metadata">

### Author: ![mirobane](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/mirobane/32/1423_2.png) [@mirobane](https://forum.clockworkpi.com/u/mirobane)
#### Post date: [December 23, 2018, 3:59pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/56 "2018-12-23T15:59:23Z")

</div>

really working well meow 🙂

---

<div class="post-metadata">

### Author: ![infernalmaster](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/infernalmaster/32/1622_2.png) [@infernalmaster](https://forum.clockworkpi.com/u/infernalmaster)
#### Post date: [February 5, 2019, 4:20pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/57 "2019-02-05T16:20:52Z")

</div>

I found that installation is very easy with launcher `1.24`.

Just place archive `pico-8_0.1.11g_raspi.zip` inside directory `/home/cpi/games/PICO-8`.

That’s all)

---

<div class="post-metadata">

### Author: ![SteveOctets](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/steveoctets/32/1705_2.png) [@SteveOctets](https://forum.clockworkpi.com/u/SteveOctets)
#### Post date: [February 11, 2019, 1:05pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/58 "2019-02-11T13:05:24Z")

</div>

I receive my GameShell and Pico 8 is awesome on it 🙂 but with my config (rebuild from 0.3 image sd card and last launcher 1.24) i have some instability: All is ok in first run after reboot but if i play some games in pico8 and quit pico8 to return to launcher when i try to restart Pico8 i have a black screen and i stuck: i can only reboot GameShell.

For someone that have the same trouble i find that if i force the size of windows in pico8 config file that correct the trouble for me. Here the change:

Edit the file ~/.lexaloffle/pico-8/config.txt (in ssh with nano)

change the line  
window\_size 0 0  
to  
window\_size 320 240

Save and that it

---

<div class="post-metadata">

### Author: ![headchris78](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/headchris78/32/1787_2.png) [@headchris78](https://forum.clockworkpi.com/u/headchris78)
#### Post date: [February 12, 2019, 1:20am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/59 "2019-02-12T01:20:38Z")

</div>

I still can’t get Pico 8 to run dropped the zip file in the directory. Edited the config file for the screen size. Nothing still a black screen and straight back to the ui.

---

<div class="post-metadata">

### Author: ![feoh](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/feoh/32/1484_2.png) [@feoh](https://forum.clockworkpi.com/u/feoh)
#### Post date: [February 13, 2019, 5:44pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/60 "2019-02-13T17:44:42Z")

</div>

Did you keep the zip file exactly the same as when you downloaded it from the Lexaloffle/Humble Bundle site? Exact same filename, extension, and case?

And you’re copying it to /home/cpi/games/PICO-8 ?

---

<div class="post-metadata">

### Author: ![headchris78](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/headchris78/32/1787_2.png) [@headchris78](https://forum.clockworkpi.com/u/headchris78)
#### Post date: [February 13, 2019, 6:32pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/61 "2019-02-13T18:32:15Z")

</div>

Yeah I sure did nothing has changed

---

<div class="post-metadata">

### Author: ![Pixelpunker](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/pixelpunker/32/1531_2.png) [@Pixelpunker](https://forum.clockworkpi.com/u/Pixelpunker)
#### Post date: [February 14, 2019, 9:35am UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/62 "2019-02-14T09:35:29Z")

</div>

Did you try to launch it twice? The first launch leads straight back to the UI, the second launch should actually run PICO-8.  
Also, maybe your config is messed up. Simply delete config.txt. Launch PICO-8, wait a little. Then close it. It should create a fresh config file on shutdown. Check if config.txt exists now and isn’t empty. Does it work now?

---

<div class="post-metadata">

### Author: ![mother3](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/mother3/32/6307_2.png) [@mother3](https://forum.clockworkpi.com/u/mother3)
#### Post date: [February 19, 2019, 5:42pm UTC](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012/63 "2019-02-19T17:42:19Z")

</div>

谢谢你的教程。  
我购买并下载了 [https://www.lexaloffle.com/pico-8.php](https://www.lexaloffle.com/pico-8.php) 之后  
将下载好的pico-8\_0.1.11g\_raspi.zip 放进我的gameshell\home\cpi\games\pico-8目录下  
直接进入已经升级到 clockworkOS v0.3的pico-8中，自动运行就搞定了。  
这个方法可以帮助不会使用linux的同学。

谢谢你的教程，🙏

[Previous page](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012.md?page=2)

[Next page](https://forum.clockworkpi.com/t/how-to-install-pico-8-on-gameshell/1012.md?page=4)
