# How to reinstall the OS

**URL:** <https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880>\
**Category:** GameShell\
**Tags:** update\
**Created:** [February 17, 2019, 5:20pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880 "2019-02-17T17:20:15Z")\
**Posts on this page:** 14\
**Page:** 1

<div class="post-metadata">

**Author:** ![Valssu](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/valssu/32/8026_2.png) [@Valssu](https://forum.clockworkpi.com/u/Valssu)\
**Post date:** [February 17, 2019, 5:20pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/1 "2019-02-17T17:20:15Z")

</div>

Hah, after updating the system via setting, the system shows me the loading screen all the time.

Well, after triggering something via SSH, I totally fucked up the system: after the CPI screen, there is only a black screen.

BTW, I cant locate the ‘launcher’.

So, maybe I should reinstall the system? How to do that via SSH? And, will I lose my pico-8 and saved data in retroarch?

---

<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:** [February 17, 2019, 5:45pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/2 "2019-02-17T17:45:36Z")

</div>

your pico8 zip is in your PC right? if not  
try to use winscp(use the cpi:cpi ssh account to login ) to copy the pico8 out of GS

but I remember that if you buy a pico8, you will have a download link in your email

so basicly , there is no need to worry about pico8,wont let you buy again

and the data in retroarch can be found and setup again because retroarch is opensource

here is the os image

> [@GameShell OS image files (v0.3-0.4)](https://forum.clockworkpi.com/t/gameshell-os-image-files-v0-3-0-4/355/1):
>
> - (v0.21) [http://106.185.33.196/clockworkos\_v0.21.img.bz2](http://106.185.33.196/clockworkos_v0.21.img.bz2)  
> MD5SUM: 8c853816594b1c6b8b998e97d177b42a  
> SIZE: 4GB [TORRENT](http://www.urlhash.com/115579/clockworkos_v0.21.img.bz2.torrent) [MAGNET] ( magnet:?xt=urn:btih:3555f7abe31814400a7cdbde71f117f17172405d&dn=clockworkos\_v0.21.img.bz2)

use dd(linux) or win32 disk [Win32 Disk Imager download | SourceForge.net](https://sourceforge.net/projects/win32diskimager/)  
to do the it ,flash the image into a TF card ,8G space Minimum

---

<div class="post-metadata">

**Author:** ![Valssu](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/valssu/32/8026_2.png) [@Valssu](https://forum.clockworkpi.com/u/Valssu)\
**Post date:** [February 17, 2019, 5:49pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/3 "2019-02-17T17:49:11Z")

</div>

Neat.  
Another thing, the major issue I am having now is that I cant find the launcher.  
So I tried “git clone [https://github.com/clockworkpi/launcher.git](https://github.com/clockworkpi/launcher.git)”, still loading now. Is that a proper way to do it?

---

<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:** [February 17, 2019, 5:51pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/4 "2019-02-17T17:51:09Z")

</div>

the launcher maybe in `/home/cpi/apps/` since v0.2, we move the launcher out of `/home/cpi/apps`

and if you did the git clone  
there is still a problem is bluetooth ,if your os image is v0.1 ,there is no bluetooth and it will cause the launcher fail to start

so the simple way is to reflash the tf card

---

<div class="post-metadata">

**Author:** ![Valssu](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/valssu/32/8026_2.png) [@Valssu](https://forum.clockworkpi.com/u/Valssu)\
**Post date:** [February 17, 2019, 5:53pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/5 "2019-02-17T17:53:38Z")

</div>

Yeah, I saw these from another post.  
Damn, the size of the OS is huge! Any tutorial of flashing the image? I am using a Mac.

But anyway, thanks mate

---

<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:** [February 17, 2019, 6:00pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/6 "2019-02-17T18:00:40Z")

</div>

mac? that’s even easier than linux

just download the **clockworkos\_v0.21.img.bz2** and unzip it( take a little long time but not hard for mac)

and mac has `dd` ,but I have not used mac for many years so I can not remember whole command line would be

in linux  
usually is

```auto
dd if=clockworkos_v0.21.img of=/dev/sdb bs=4096

```

the `/dev/sdb` is the device identification of the TF card, usually  
I can get it by

```auto
dmesg | tail

```

when I plug the TF card in , the mac can do this ,too,but I can not remember how and which

For mac  
I think command line is not the first choice  
There must be a GUI tools can do the `dd` job

try disk manger

there is no big risk ,you just need to look out be carefully chose the disk you are gonna do , **do not choose the main HDD of mac os**

---

<div class="post-metadata">

**Author:** ![Valssu](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/valssu/32/8026_2.png) [@Valssu](https://forum.clockworkpi.com/u/Valssu)\
**Post date:** [February 17, 2019, 6:03pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/7 "2019-02-17T18:03:25Z")

</div>

Cheers. Will have a try.

BTW, why the ssh is very slow? Any reason? Something wrong with my Mac?

---

<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:** [February 17, 2019, 6:06pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/8 "2019-02-17T18:06:04Z")

</div>

Not at all,you mac is fine

We did not realize the problem until one of us in this community find out that,

the linux system of GS has wif power save on by default and it casue the lower speed of WIFI (ssh)

and in the later os image, launcher has fixed it

---

<div class="post-metadata">

**Author:** ![Valssu](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/valssu/32/8026_2.png) [@Valssu](https://forum.clockworkpi.com/u/Valssu)\
**Post date:** [February 17, 2019, 6:07pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/9 "2019-02-17T18:07:55Z")

</div>

Gotcha. BTW, should I move tha ‘launcher’ from /apps to the default direction?

---

<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:** [February 17, 2019, 6:12pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/10 "2019-02-17T18:12:14Z")

</div>

move the launcher is not enough to fix your gs right now,

if you flashed the os image ,lanuncher will be in the new location

---

<div class="post-metadata">

**Author:** ![Valssu](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/valssu/32/8026_2.png) [@Valssu](https://forum.clockworkpi.com/u/Valssu)\
**Post date:** [February 17, 2019, 6:12pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/11 "2019-02-17T18:12:53Z")

</div>

OK, so I have to download them now. Cheers mate. Hope next update is less troublesome…

---

<div class="post-metadata">

**Author:** ![Valssu](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/valssu/32/8026_2.png) [@Valssu](https://forum.clockworkpi.com/u/Valssu)\
**Post date:** [February 17, 2019, 6:18pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/12 "2019-02-17T18:18:05Z")

</div>

A small question, mate: any recommendation for learning linux? It seems that I need to learn some Linux to make the full use of game shell.

---

<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:** [February 17, 2019, 11:53pm UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/13 "2019-02-17T23:53:23Z")

</div>

On the Mac, command line is the easiest way. First enter `diskutil list` to find your memory card. Look for the card and its number on the right (diskX). Ignore the partition numbers, they will be wiped. Then unmount the card and proceed to copy to it:

```auto
diskutil umountDisk diskX
dd if=~/<path to folder>/clockworkos_v0.21.img of=/dev/rdiskX bs=4m
```

Replace the `X` with the disk number from the `diskutil list` command.

---

<div class="post-metadata">

**Author:** ![eoiue](https://avatars.discourse-cdn.com/v4/letter/e/0ea827/32.png) [@eoiue](https://forum.clockworkpi.com/u/eoiue)\
**Post date:** [February 18, 2019, 8:44am UTC](https://forum.clockworkpi.com/t/how-to-reinstall-the-os/2880/14 "2019-02-18T08:44:49Z")

</div>

[https://linuxjourney.com/](https://linuxjourney.com/)

Really well put together website.
