# Tutorials

**URL:** https://forum.clockworkpi.com/c/tutorials/9.md

[Latest](https://forum.clockworkpi.com/latest.md) · [Categories](https://forum.clockworkpi.com/categories.md) · [Tags](https://forum.clockworkpi.com/tags.md)

---

## [UNIX Tutorial for Beginners](https://forum.clockworkpi.com/t/unix-tutorial-for-beginners/3897)

<div class="topic-metadata">

**Author:** [@Petrakis](https://forum.clockworkpi.com/u/Petrakis)\
**Replies:** 2\
**Last updated:** [January 30, 2024, 8:39pm UTC](https://forum.clockworkpi.com/t/unix-tutorial-for-beginners/3897 "2024-01-30T20:39:17Z")

</div>

If you are new to this amazing operating system and don’t know where to start here you can find the most relevant topic you need to know to enjoy your gameshell. Click on the chapter you are interested to get redirected…

---

## [\[USB-ETH\] How to transfer files if you have unstable wifi](https://forum.clockworkpi.com/t/usb-eth-how-to-transfer-files-if-you-have-unstable-wifi/958)

<div class="topic-metadata">

**Author:** [@Petrakis](https://forum.clockworkpi.com/u/Petrakis)\
**Replies:** 48\
**Last updated:** [November 6, 2021, 8:29am UTC](https://forum.clockworkpi.com/t/usb-eth-how-to-transfer-files-if-you-have-unstable-wifi/958 "2021-11-06T08:29:15Z")

</div>

Many of you have probably experienced that the wifi signal is weak specially if you have the router behind walls (compared to other devices, like smartphones). That in some cases makes it a pain to transfer files or dow…

---

## [How to add new emulators (Gameboy, SNES, etc.)](https://forum.clockworkpi.com/t/how-to-add-new-emulators-gameboy-snes-etc/862)

<div class="topic-metadata">

**Author:** [@nouty](https://forum.clockworkpi.com/u/nouty)\
**Replies:** 82\
**Last updated:** [December 9, 2019, 5:56pm UTC](https://forum.clockworkpi.com/t/how-to-add-new-emulators-gameboy-snes-etc/862 "2019-12-09T17:56:55Z")

</div>

Hi there, because of my lacking experience with SSH, Linux, and much more, I was able to get emulators working by several snippets of guidance of you guys here at the forums. Due to maaaaany people here that don’t know…

---

## [How to change time on the GameShell](https://forum.clockworkpi.com/t/how-to-change-time-on-the-gameshell/861)

<div class="topic-metadata">

**Author:** [@skywalker101](https://forum.clockworkpi.com/u/skywalker101)\
**Replies:** 6\
**Last updated:** [August 6, 2018, 6:05pm UTC](https://forum.clockworkpi.com/t/how-to-change-time-on-the-gameshell/861 "2018-08-06T18:05:42Z")

</div>

This thread has all info on how you can change the timezone on your GameShell What you need: Hardware A wireless network connection (WiFi) :globe\_with\_meridians: A GameShell unit :video\_game: A computer with access …

---

## [How to transfer files with TinyCloud through SSH](https://forum.clockworkpi.com/t/how-to-transfer-files-with-tinycloud-through-ssh/833)

<div class="topic-metadata">

**Author:** [@skywalker101](https://forum.clockworkpi.com/u/skywalker101)\
**Replies:** 26\
**Last updated:** [April 12, 2021, 12:36pm UTC](https://forum.clockworkpi.com/t/how-to-transfer-files-with-tinycloud-through-ssh/833 "2021-04-12T12:36:40Z")

</div>

This thread has all info on how you can enter the TinyCloud on GameShell through SSH. What you need: Hardware A wireless network connection (WiFi) :globe\_with\_meridians: A GameShell unit :video\_game: A computer wit…

---

## [SMD soldering, even with a standard soldering iron](https://forum.clockworkpi.com/t/smd-soldering-even-with-a-standard-soldering-iron/21111)

<div class="topic-metadata">

**Author:** [@Codiator](https://forum.clockworkpi.com/u/Codiator)\
**Replies:** 1\
**Last updated:** [September 8, 2026, 10:08pm UTC](https://forum.clockworkpi.com/t/smd-soldering-even-with-a-standard-soldering-iron/21111 "2026-09-08T22:08:30Z")

</div>

Given recent events, I took a quick look to see if there was a short, useful video showing how to solder SMD components easily. I think the following video is good and might help some readers, especially since it also s…

---

## [UART wiring for USB TTL on uconsole](https://forum.clockworkpi.com/t/uart-wiring-for-usb-ttl-on-uconsole/21114)

<div class="topic-metadata">

**Author:** [@randomlinuxuser](https://forum.clockworkpi.com/u/randomlinuxuser)\
**Replies:** 1\
**Last updated:** [January 19, 2026, 1:41am UTC](https://forum.clockworkpi.com/t/uart-wiring-for-usb-ttl-on-uconsole/21114 "2026-01-19T01:41:25Z")

</div>

Hey everyone, I’m trying to connect a USB TTL adapter to the UART pins and just want to confirm I’m wiring it correctly. This is what I have right now: TX (GPIO 14): Pin 8 → RX of USB TTL RX (GPIO 15): Pin 10 …

---

## [Which core for MAME 0.184 ROMS?](https://forum.clockworkpi.com/t/which-core-for-mame-0-184-roms/1190)

<div class="topic-metadata">

**Author:** [@Fuseps](https://forum.clockworkpi.com/u/Fuseps)\
**Replies:** 2\
**Last updated:** [October 31, 2025, 2:35pm UTC](https://forum.clockworkpi.com/t/which-core-for-mame-0-184-roms/1190 "2025-10-31T14:35:14Z")

</div>

Hi everyone, I’m quite new to things like gameshell and how they work. I have a stack of MAME 0.184 ROMS that I’d like to play on my gameshell, but for the life of me I can’t figure out which core I need to use for them…

---

## [A General Guide to Porting Distros to the uConsole and Devterm](https://forum.clockworkpi.com/t/a-general-guide-to-porting-distros-to-the-uconsole-and-devterm/20156)

<div class="topic-metadata">

**Author:** [@crossplatformdev](https://forum.clockworkpi.com/u/crossplatformdev)\
**Replies:** 1\
**Last updated:** [October 21, 2025, 2:38pm UTC](https://forum.clockworkpi.com/t/a-general-guide-to-porting-distros-to-the-uconsole-and-devterm/20156 "2025-10-21T14:38:17Z")

</div>

Hi everyone, I’d like to share a guide on how to port a distro to the uConsole, since there’s very little documentation available. In essence, the process comes down to installing a kernel that already includes the dri…

---

## [Multicast DNS (mDNS): simple uconsole access without ip guessing](https://forum.clockworkpi.com/t/multicast-dns-mdns-simple-uconsole-access-without-ip-guessing/19904)

<div class="topic-metadata">

**Author:** [@white-round-square](https://forum.clockworkpi.com/u/white-round-square)\
**Replies:** 0\
**Last updated:** [September 29, 2025, 1:42am UTC](https://forum.clockworkpi.com/t/multicast-dns-mdns-simple-uconsole-access-without-ip-guessing/19904 "2025-09-29T01:42:37Z")

</div>

Hello my dear friend! Would you like idea to be able to do: $ ssh uconsole $ scp -r local\_folder uconsole: Looks cool, right? But you do not want to use any DNS servers and annoyed by /etc/hosts/? You won’t believe, …

---

## [Simple 3D engine for mmbasic possible?](https://forum.clockworkpi.com/t/simple-3d-engine-for-mmbasic-possible/19968)

<div class="topic-metadata">

**Author:** [@Catboy](https://forum.clockworkpi.com/u/Catboy)\
**Replies:** 1\
**Last updated:** [October 5, 2025, 6:25pm UTC](https://forum.clockworkpi.com/t/simple-3d-engine-for-mmbasic-possible/19968 "2025-10-05T18:25:44Z")

</div>

Heyoo quick question I’d like to make a simple 3D engine in MMbasic for the picocalc. I’ve seen people do it on the picocalc in python but none for MMbasic. Is it possible? Or just impractical to the point where it’s …

---

## [Help! Devterm nor Uconsole boot with 128Gb micro sd](https://forum.clockworkpi.com/t/help-devterm-nor-uconsole-boot-with-128gb-micro-sd/19415)

<div class="topic-metadata">

**Author:** [@SirCodesAlot](https://forum.clockworkpi.com/u/SirCodesAlot)\
**Replies:** 1\
**Last updated:** [August 26, 2025, 3:23am UTC](https://forum.clockworkpi.com/t/help-devterm-nor-uconsole-boot-with-128gb-micro-sd/19415 "2025-08-26T03:23:15Z")

</div>

Hi Clockwork Pi. I’m having difficulty upgrading my Devterm, and uconsole, as follows: flashed OS onto Lexar 256Gb micro sd, just following the recipe. Removed 16Gb ssd card from Devterm, installed 256Gb - won’t boot. …

---

## [How to charge Gameshell that's missing its USB port?](https://forum.clockworkpi.com/t/how-to-charge-gameshell-thats-missing-its-usb-port/6752)

<div class="topic-metadata">

**Author:** [@Nathan\_Lee](https://forum.clockworkpi.com/u/Nathan_Lee)\
**Replies:** 4\
**Last updated:** [September 29, 2024, 5:05pm UTC](https://forum.clockworkpi.com/t/how-to-charge-gameshell-thats-missing-its-usb-port/6752 "2024-09-29T17:05:22Z")

</div>

Hi. A while ago, my Gameshell’s USB port came off. I knew I couldn’t fix it myself, so I asked the forum when the mainboard would be back in stock and if there was a way I could replace the USB port on my own. The full t…

---

## [Godot Engine GameDev: GameShell Edition \[Tutorial\]](https://forum.clockworkpi.com/t/godot-engine-gamedev-gameshell-edition-tutorial/6290)

<div class="topic-metadata">

**Author:** [@Samdze](https://forum.clockworkpi.com/u/Samdze)\
**Replies:** 25\
**Last updated:** [January 19, 2024, 5:54pm UTC](https://forum.clockworkpi.com/t/godot-engine-gamedev-gameshell-edition-tutorial/6290 "2024-01-19T17:54:40Z")

</div>

Run Godot games on the GameShell! Hi everyone! In the last weeks I investigated a bit on how to compile the Godot Engine and run Godot games on the GameShell. This is a tutorial on how to do the same on your machine! G…

---

## [Run Unity3D-Game On GameShell](https://forum.clockworkpi.com/t/run-unity3d-game-on-gameshell/4587)

<div class="topic-metadata">

**Author:** [@zzxzzk115](https://forum.clockworkpi.com/u/zzxzzk115)\
**Replies:** 10\
**Last updated:** [June 11, 2022, 4:16am UTC](https://forum.clockworkpi.com/t/run-unity3d-game-on-gameshell/4587 "2022-06-11T04:16:04Z")

</div>

You just need to create a game by Unity3D(320\*240) and export as a WebGL project(the Template is Minimal), then use nw.js to run the game. See details at GitHub - zzxzzk115/NW-Unity: NW-Unity is a tool for auto packing …

---

## [Custom Keyboard and Software Compatibility](https://forum.clockworkpi.com/t/custom-keyboard-and-software-compatibility/8506)

<div class="topic-metadata">

**Author:** [@Zoey](https://forum.clockworkpi.com/u/Zoey)\
**Replies:** 2\
**Last updated:** [May 28, 2022, 12:35am UTC](https://forum.clockworkpi.com/t/custom-keyboard-and-software-compatibility/8506 "2022-05-28T00:35:21Z")

</div>

I’ve been looking for the core to a build I have in mind. Pretty much a small laptop. And the clockwork pi seems perfect! But before I get started I had a few questions that didn’t have definitive answers anywhere else. …

---

## [Which OpenGL version is supported?](https://forum.clockworkpi.com/t/which-opengl-version-is-supported/1995)

<div class="topic-metadata">

**Author:** [@KestrelSoftworks](https://forum.clockworkpi.com/u/KestrelSoftworks)\
**Replies:** 5\
**Last updated:** [January 21, 2022, 9:04pm UTC](https://forum.clockworkpi.com/t/which-opengl-version-is-supported/1995 "2022-01-21T21:04:34Z")

</div>

Hi, I’m quite impressed by the project, and considering my self buy a couple of GameShells for development. One question I have in my head is if there’s a posibility to make 3D games and/or apps for it. Which OpenGL i…

---

## [Let’s play Pokemon MMO - WIP](https://forum.clockworkpi.com/t/let-s-play-pokemon-mmo-wip/5216)

<div class="topic-metadata">

**Author:** [@javelinface](https://forum.clockworkpi.com/u/javelinface)\
**Replies:** 4\
**Last updated:** [December 7, 2021, 2:43am UTC](https://forum.clockworkpi.com/t/let-s-play-pokemon-mmo-wip/5216 "2021-12-07T02:43:56Z")

</div>

I decided on a whim to see if PokeMMO would work on the gameshell. GOOD NEWS! It runs! The problem is, the resolution is absolutely stupid. I’m going to try and make it behave. Hopefully. That said, running it via…

---

## [New Mainboard - Difference in performance to the old one](https://forum.clockworkpi.com/t/new-mainboard-difference-in-performance-to-the-old-one/2057)

<div class="topic-metadata">

**Author:** [@uke](https://forum.clockworkpi.com/u/uke)\
**Replies:** 2\
**Last updated:** [February 20, 2021, 10:56pm UTC](https://forum.clockworkpi.com/t/new-mainboard-difference-in-performance-to-the-old-one/2057 "2021-02-20T22:56:56Z")

</div>

Hi, First of all, thanks for the free shipping on the new board. I’m having a hard time deciding if the 1GB Ram is enough to justify the $49 price tag. I won’t use the HDMI out that much I think, so that doesn’t count. …

---

## [Copying an image to flash to a larger SD card](https://forum.clockworkpi.com/t/copying-an-image-to-flash-to-a-larger-sd-card/6192)

<div class="topic-metadata">

**Author:** [@detourne](https://forum.clockworkpi.com/u/detourne)\
**Replies:** 3\
**Last updated:** [January 21, 2021, 11:17pm UTC](https://forum.clockworkpi.com/t/copying-an-image-to-flash-to-a-larger-sd-card/6192 "2021-01-21T23:17:27Z")

</div>

Hi guys, I’m sure I’ve done this in the past, but can’t quite remember. I’d like to be able to make a copy of a flashed SD card and put it onto a larger SD card. I’ve got Javelinface’s DEOT+v0.5 with a number of modifi…

---

## [Gameshell Will Not Power On \[SOLVED\]](https://forum.clockworkpi.com/t/gameshell-will-not-power-on-solved/760)

<div class="topic-metadata">

**Author:** [@Kryz\_Braun](https://forum.clockworkpi.com/u/Kryz_Braun)\
**Replies:** 13\
**Last updated:** [December 14, 2020, 3:40pm UTC](https://forum.clockworkpi.com/t/gameshell-will-not-power-on-solved/760 "2020-12-14T15:40:45Z")

</div>

Hello! I have assembled the gameshell as instructed, disassembled, and assembled again but it does not turn on. I have tried it plugged in and unplugged and with and without the SD card inserted. I have also let it sit a…

---

## [Any way to install accelerated VLC/Mplayer, and and Image viewer? -\> Kodi works!](https://forum.clockworkpi.com/t/any-way-to-install-accelerated-vlc-mplayer-and-and-image-viewer-kodi-works/1753)

<div class="topic-metadata">

**Author:** [@denis1983](https://forum.clockworkpi.com/u/denis1983)\
**Replies:** 8\
**Last updated:** [September 9, 2020, 6:29pm UTC](https://forum.clockworkpi.com/t/any-way-to-install-accelerated-vlc-mplayer-and-and-image-viewer-kodi-works/1753 "2020-09-09T18:29:51Z")

</div>

Hi, I wanted to ask if there’s already info on installing vlc/mplayer and an image viewer on the clockwork pi? I have found the usual sites on how to install them on the raspberry, but hardware is not exactly the same,…

---

## [How to install Kodi in OS V0.21?](https://forum.clockworkpi.com/t/how-to-install-kodi-in-os-v0-21/2316)

<div class="topic-metadata">

**Author:** [@1115](https://forum.clockworkpi.com/u/1115)\
**Replies:** 13\
**Last updated:** [September 9, 2020, 2:35am UTC](https://forum.clockworkpi.com/t/how-to-install-kodi-in-os-v0-21/2316 "2020-09-09T02:35:44Z")

</div>

I try to install Kodi in my Gameshell, and I use comm-line like follow: sudo apt-get update sudo apt-get install kodi cd /home/cpi/launcher/Menu/GameShell echo ‘kodi’ \> ‘kodi.sh’ when I finish all over this, and re…

---

## [When will the shop be back in stock/How to repair damaged parts manually?](https://forum.clockworkpi.com/t/when-will-the-shop-be-back-in-stock-how-to-repair-damaged-parts-manually/5877)

<div class="topic-metadata">

**Author:** [@Nathan\_Lee](https://forum.clockworkpi.com/u/Nathan_Lee)\
**Replies:** 6\
**Last updated:** [September 5, 2020, 9:05pm UTC](https://forum.clockworkpi.com/t/when-will-the-shop-be-back-in-stock-how-to-repair-damaged-parts-manually/5877 "2020-09-05T21:05:57Z")

</div>

Sorry in advance if this is in the wrong section. A little while ago, my Gameshell stopped charging properly, so I took it apart to try to fix the issue. It turned out that the usb charging port was bent out of place, s…

---

## [SuperTuxKart on gameshell](https://forum.clockworkpi.com/t/supertuxkart-on-gameshell/5882)

<div class="topic-metadata">

**Author:** [@Itay\_Alush](https://forum.clockworkpi.com/u/Itay_Alush)\
**Replies:** 0\
**Last updated:** [August 30, 2020, 2:09pm UTC](https://forum.clockworkpi.com/t/supertuxkart-on-gameshell/5882 "2020-08-30T14:09:07Z")

</div>

does anyone know how to install SuperTuxKart on the gameshell? im new to the gameshell but i have some linux knowledge thanks!

---

## [Full desktop window manager configuration?](https://forum.clockworkpi.com/t/full-desktop-window-manager-configuration/2847)

<div class="topic-metadata">

**Author:** [@Michael](https://forum.clockworkpi.com/u/Michael)\
**Replies:** 6\
**Last updated:** [August 18, 2020, 9:29am UTC](https://forum.clockworkpi.com/t/full-desktop-window-manager-configuration/2847 "2020-08-18T09:29:54Z")

</div>

Now that I’ve got the Bluetooth working (see @lasvegas very helpful instructions) I tried to make use of the full desktop via the HDMI connection. I don’t have a Bluetooth mouse so can’t move the focus out of the Launch…

---

## [\[Tutorial\] How to compile and upload code to the keypad](https://forum.clockworkpi.com/t/tutorial-how-to-compile-and-upload-code-to-the-keypad/1065)

<div class="topic-metadata">

**Author:** [@Petrakis](https://forum.clockworkpi.com/u/Petrakis)\
**Replies:** 10\
**Last updated:** [June 23, 2020, 6:33pm UTC](https://forum.clockworkpi.com/t/tutorial-how-to-compile-and-upload-code-to-the-keypad/1065 "2020-06-23T18:33:34Z")

</div>

I decided to change the buttons layout of my cpi, from XY AB to AB XY because I felt more confortable that way and the thumb is in a better resting position, also I am really used to a Gameboy Color position And found…

---

## [Picture / Slideshow Viewer \[how to setup\]](https://forum.clockworkpi.com/t/picture-slideshow-viewer-how-to-setup/4050)

<div class="topic-metadata">

**Author:** [@WidgetPhreak](https://forum.clockworkpi.com/u/WidgetPhreak)\
**Replies:** 1\
**Last updated:** [June 23, 2020, 6:22pm UTC](https://forum.clockworkpi.com/t/picture-slideshow-viewer-how-to-setup/4050 "2020-06-23T18:22:27Z")

</div>

So, I was playing around with Feh \[which came pre-installed for displaying those lovely splash screens\] and I wasn’t having an easy time getting it to display images the way I wanted \[I wanted to be able to hit Forward/…

---

## [I want to restore my gameshell to the state I received it](https://forum.clockworkpi.com/t/i-want-to-restore-my-gameshell-to-the-state-i-received-it/2780)

<div class="topic-metadata">

**Author:** [@Son](https://forum.clockworkpi.com/u/Son)\
**Replies:** 10\
**Last updated:** [June 19, 2020, 5:11am UTC](https://forum.clockworkpi.com/t/i-want-to-restore-my-gameshell-to-the-state-i-received-it/2780 "2020-06-19T05:11:21Z")

</div>

Hi there, I am new to programming, messed up big time and now I just want to restore everything to how it was when it was shipped(default). Is this possible?

---

## [Help me get games on this thing](https://forum.clockworkpi.com/t/help-me-get-games-on-this-thing/5735)

<div class="topic-metadata">

**Author:** [@Nerdy](https://forum.clockworkpi.com/u/Nerdy)\
**Replies:** 1\
**Last updated:** [June 13, 2020, 9:18pm UTC](https://forum.clockworkpi.com/t/help-me-get-games-on-this-thing/5735 "2020-06-13T21:18:12Z")

</div>

I have tried reading the forum and every YouTube video I can find but I cannot get games on here. Ive been using FileZilla to help but it is not working.Im using macOS. I would like to find a good rom website but the int…

[Next page](https://forum.clockworkpi.com/c/tutorials/9.md?page=1)
