# How to get Tuxemon up and running on your Gameshell

**URL:** <https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220>\
**Category:** Games\
**Created:** [August 4, 2018, 7:04pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220 "2018-08-04T19:04:00Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![Qiangong2](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/qiangong2/32/794_2.png) [@Qiangong2](https://forum.clockworkpi.com/u/Qiangong2)\
**Post date:** [August 4, 2018, 7:04pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/1 "2018-08-04T19:04:00Z")

</div>

Hello Everyone! Today I am going to walk you through the steps to get Tuxemon working on your Gameshell.

Difficulty (1-5): 2.5ish - Depends on your knowledge of the terminal

What you need:

1. WiFi connection
2. Device to ssh from
3. Gameshell 😛

First you’ll want to ssh into the Gameshell from your favorite terminal. Once you do that, you should see this:  
 ![Capture](https://cdck-file-uploads-canada1.s3.dualstack.ca-central-1.amazonaws.com/flex029/uploads/clockworkpi/original/1X/72b35f6235a5bfd0c872e49fd48b50bae2faf273.PNG)

After that, type the commands:  
`cd games`  
`mkdir tuxemon`

From there, you should have a directory called “tuxemon” as shown here:  
 ![Capture](https://cdck-file-uploads-canada1.s3.dualstack.ca-central-1.amazonaws.com/flex029/uploads/clockworkpi/original/1X/c79a8d48d03d5ef778731a54159fe04750b83628.PNG)

After that, enter these commands:  
`sudo apt-get update`  
`sudo apt-get build-dep python-pygame`

After, that is done, run this command (NOTE: Will take a while):  
`git clone https://github.com/Tuxemon/Tuxemon.git -b development tuxemon`

After that, we need to update pygame and install more dependencies:  
`cd tuxemon`  
`pip install -U -r requirements.txt`

This will definitely take a while. Seriously. Go make yourself dinner or something.

Once it is finally done, it is time to launch the game!

When it first boots up, you may have an issue with the scaling. To make it function correctly, edit the file ~/.tuxemon/tuxemon.cfg to say:

```
resolution_x = 320
resolution_y = 240

```

Then find `large_gui` and set it to `true`

To get Tuxemon to show up on the main menu, enter these commands  
`touch ~/apps/launcher/Menu/GameShell/Tuxemon.sh`  
`echo "python ~/games/tuxemon/tuxemon.py" > ~/apps/launcher/Menu/GameShell/Tuxemon.sh`  
`cd ~/apps/launcher/Menu/GameShell/`  
`chmod a+x Tuxemon.sh`

Then reboot your gameshell. An image will be added when the game gets closer to completion.

You should be all set! Boot up Tuxemon and it should run fine!

When you want to update Tuxemon, just go back to the source directory, and type the command:  
`git pull`

It will update Tuxemon to the latest version!

Have Fun!

---

<div class="post-metadata">

**Author:** ![Qiangong2](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/qiangong2/32/794_2.png) [@Qiangong2](https://forum.clockworkpi.com/u/Qiangong2)\
**Post date:** [August 4, 2018, 7:07pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/2 "2018-08-04T19:07:04Z")

</div>

Just a note:

Tuxemon is a WIP game, we are working on ironing out the kinks and finishing the story.

Bugs:  
Not finished story  
Battle Sequence doesn’t scale properly

---

<div class="post-metadata">

**Author:** ![ElMaximus1987](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/elmaximus1987/32/756_2.png) [@ElMaximus1987](https://forum.clockworkpi.com/u/ElMaximus1987)\
**Post date:** [August 4, 2018, 9:24pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/3 "2018-08-04T21:24:28Z")

</div>

I can’t seem to find the tuxemon.cfg. Can anyone help me out please?

---

<div class="post-metadata">

**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 4, 2018, 9:25pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/4 "2018-08-04T21:25:48Z")

</div>

You need to launch the application once for the config to be written.  
Then it will be in your home directory (in a hidden .tuxemon directory)

---

<div class="post-metadata">

**Author:** ![ElMaximus1987](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/elmaximus1987/32/756_2.png) [@ElMaximus1987](https://forum.clockworkpi.com/u/ElMaximus1987)\
**Post date:** [August 4, 2018, 9:26pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/5 "2018-08-04T21:26:46Z")

</div>

I found it. Thank You.

---

<div class="post-metadata">

**Author:** ![Pequeno\_Pedrinho](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/pequeno_pedrinho/32/4675_2.png) [@Pequeno\_Pedrinho](https://forum.clockworkpi.com/u/Pequeno_Pedrinho)\
**Post date:** [August 4, 2018, 10:29pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/6 "2018-08-04T22:29:17Z")

</div>

how do i launch without the app in the launcher?

---

<div class="post-metadata">

**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 4, 2018, 10:35pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/7 "2018-08-04T22:35:40Z")

</div>

`python ~/games/tuxemon/tuxemon.py`

---

<div class="post-metadata">

**Author:** ![Pequeno\_Pedrinho](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/pequeno_pedrinho/32/4675_2.png) [@Pequeno\_Pedrinho](https://forum.clockworkpi.com/u/Pequeno_Pedrinho)\
**Post date:** [August 4, 2018, 10:55pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/8 "2018-08-04T22:55:55Z")

</div>

i did everything and the resolution is still weird

---

<div class="post-metadata">

**Author:** ![Qiangong2](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/qiangong2/32/794_2.png) [@Qiangong2](https://forum.clockworkpi.com/u/Qiangong2)\
**Post date:** [August 4, 2018, 11:27pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/9 "2018-08-04T23:27:43Z")

</div>

Can you upload a picture please?

---

<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:** [August 7, 2018, 4:58am UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/10 "2018-08-07T04:58:27Z")

</div>

One last item for the OP!

> cd ~/apps/launcher/skin/default/Menu/GameShell/  
> cp ~/games/tuxemon/tuxemon/resources/gfx/icon.png Tuxemon.png

…to give it an icon. Or you could download my slightly modified version to be more inline with the rest of the icons…

![Tuxemon](https://canada1.discourse-cdn.com/flex029/uploads/clockworkpi/original/1X/22a846d462dfe2b221d69a4cc7fe3bdf6bb95a46.png)

---

<div class="post-metadata">

**Author:** ![Qiangong2](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/qiangong2/32/794_2.png) [@Qiangong2](https://forum.clockworkpi.com/u/Qiangong2)\
**Post date:** [August 7, 2018, 5:38am UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/11 "2018-08-07T05:38:18Z")

</div>

That’s awesome @lasvegas!

Would you be willing to make a pull request with your icon? That way, we can have it later on too 😃

---

<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:** [August 7, 2018, 7:30am UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/12 "2018-08-07T07:30:01Z")

</div>

I have no idea how to do that! 🙂

LasVegas

---

<div class="post-metadata">

**Author:** ![Pequeno\_Pedrinho](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/pequeno_pedrinho/32/4675_2.png) [@Pequeno\_Pedrinho](https://forum.clockworkpi.com/u/Pequeno_Pedrinho)\
**Post date:** [August 10, 2018, 3:56pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/13 "2018-08-10T15:56:02Z")

</div>

> [@Qiangong2](#):
>
> Can you upload a picture please?

 ![29](https://canada1.discourse-cdn.com/flex029/uploads/clockworkpi/original/1X/009bdd677e56fbaec0e82bedaf988b1bb3f99bb1.jpeg)  
and here is the code [https://hastebin.com/guvedebano.ini](https://hastebin.com/guvedebano.ini)

---

<div class="post-metadata">

**Author:** ![Nielsvd](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/nielsvd/32/967_2.png) [@Nielsvd](https://forum.clockworkpi.com/u/Nielsvd)\
**Post date:** [August 14, 2018, 7:34pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/14 "2018-08-14T19:34:35Z")

</div>

Hi first of all thnx for the tutorial. Following the steps worked fine for me 🙂. Is there a possibility to change the key mappings? At the moment a have to do everything with the start and menu buttons. Looking forward to play the game a bit more.

---

<div class="post-metadata">

**Author:** ![Lix](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/lix/32/3394_2.png) [@Lix](https://forum.clockworkpi.com/u/Lix)\
**Post date:** [August 23, 2019, 10:31pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/15 "2019-08-23T22:31:15Z")

</div>

I have a question about all of this. I am new to pygames.  
Once I do all these steps I have Tuxemon installed but how do I install other PyGames from [icth.io](http://icth.io) for example.

Their games are in a folder, can I just put the said folder in /home/cpi/games, create a launcher.sh link to the .py and I am all set?

---

<div class="post-metadata">

**Author:** ![anorman728](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/anorman728/32/3336_2.png) [@anorman728](https://forum.clockworkpi.com/u/anorman728)\
**Post date:** [September 22, 2019, 3:18am UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/16 "2019-09-22T03:18:02Z")

</div>

I’m actually getting this error when running the pip command–

```
Command "python setup.py egg_info" failed with error code 1 in /tmp/pip-install-up8Obo/pygame/

```

Prior to that, this message appears

```
Hunting dependencies...
SDL : found 1.2.15
FONT : found
IMAGE : found
MIXER : not found
PNG : found
JPEG : found
SCRAP : found
PORTMIDI: not found
PORTTIME: not found
FREETYPE: found 22.1.16
Missing dependencies

```

I’m pretty sure I’ve seen this error before in my own Py projects, but I don’t remember how to resolve it. Everything I’ve seen online says to basically update everything, but it doesn’t seem to make any difference for me. I’ve also tried using pip3 instead of pip.

### UPDATE

I was able to fix this by running these commands:

```
apt-get build-dep python-pygame
sudo apt-get install libxml2 libxml2-dev libxslt1-dev

```

The latter command actually had to do with a _new_ problem that arose after building the dependencies.

If anyone else has any other confusions that I had, I was able to launch the game by navigating to the tuxemon directory through Dingux. (I wasn’t able to launch through SSH since it wasn’t connected to the X server.) Then, since only the top-left part of the screen could be showed, so I couldn’t see the menu to exit, I had to force-shut off the system to restart it.

The game’s working now, though the controls are a little weird-- The only two usable buttons are Start and MENU, matching Tuxemon’s Enter/Escape from the PC controls. I actually started to manually change them in the source code, but that’s not really a good idea because then you could get merge conflicts on updating.

---

<div class="post-metadata">

**Author:** ![2000brix](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/2000brix/32/4051_2.png) [@2000brix](https://forum.clockworkpi.com/u/2000brix)\
**Post date:** [June 15, 2020, 12:03am UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/17 "2020-06-15T00:03:30Z")

</div>

I followed all the steps on my box-fresh GameShell, and it won’t run.  
IDK what happened, heres the terminal output:

> **[Terminal Output.txt](https://drive.google.com/file/d/1g8wLT7nR15TGe4Tt4chQT1FoX03-jajQ/view?usp=sharing)**
>
> Google Drive file.

---

<div class="post-metadata">

**Author:** ![2000brix](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/2000brix/32/4051_2.png) [@2000brix](https://forum.clockworkpi.com/u/2000brix)\
**Post date:** [June 15, 2020, 12:04am UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/18 "2020-06-15T00:04:09Z")

</div>

It seems it didn’t even create the Tuxemon folder…

---

<div class="post-metadata">

**Author:** ![r043v](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/r043v/32/672_2.png) [@r043v](https://forum.clockworkpi.com/u/r043v)\
**Post date:** [June 15, 2020, 12:33am UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/19 "2020-06-15T00:33:31Z")

</div>

you miss packages \>

> ```
> Error: Please make sure the libxml2 and libxslt development packages are installed.
> 
> ```

apt install these \>

[https://packages.debian.org/en/jessie/libxml2-dev](https://packages.debian.org/en/jessie/libxml2-dev)  
[https://packages.debian.org/en/jessie/libxslt-dev](https://packages.debian.org/en/jessie/libxslt-dev)

and folder where you want create your shortcut, “/home/cpi/apps/launcher/Menu/GameShell/”  
not exist, it must be for an old clockwork os location, check your menu folder real location

```
cpi@clockworkpi:~/games/tuxemon$ touch ~/apps/launcher/Menu/GameShell/Tuxemon.sh
touch: cannot touch '/home/cpi/apps/launcher/Menu/GameShell/Tuxemon.sh': No such file or directory
cpi@clockworkpi:~/games/tuxemon$ echo "python ~/games/tuxemon/tuxemon.py" > ~/apps/launcher/Menu/GameShell/Tuxemon.sh
-bash: /home/cpi/apps/launcher/Menu/GameShell/Tuxemon.sh: No such file or directory
cpi@clockworkpi:~/games/tuxemon$ cd ~/apps/launcher/Menu/GameShell/
-bash: cd: /home/cpi/apps/launcher/Menu/GameShell/: No such file or directory

```

---

<div class="post-metadata">

**Author:** ![2000brix](https://yyz1.discourse-cdn.com/flex029/user_avatar/forum.clockworkpi.com/2000brix/32/4051_2.png) [@2000brix](https://forum.clockworkpi.com/u/2000brix)\
**Post date:** [June 15, 2020, 10:14pm UTC](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220/20 "2020-06-15T22:14:21Z")

</div>

Thanks. @anorman728 How do you run the game straight from Dingux?

[Next page](https://forum.clockworkpi.com/t/how-to-get-tuxemon-up-and-running-on-your-gameshell/1220.md?page=2)
