How to get Tuxemon up and running on your Gameshell

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 :stuck_out_tongue:

First you’ll want to ssh into the Gameshell from your favorite terminal. Once you do that, you should see this:

After that, type the commands:
cd games
mkdir tuxemon

From there, you should have a directory called “tuxemon” as shown here:

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 -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/
echo "python ~/games/tuxemon/" > ~/apps/launcher/Menu/GameShell/
cd ~/apps/launcher/Menu/GameShell/
chmod a+x

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!


Just a note:

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

Not finished story
Battle Sequence doesn’t scale properly

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

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)

I found it. Thank You.

how do i launch without the app in the launcher?

1 Like

python ~/games/tuxemon/

1 Like

i did everything and the resolution is still weird

Can you upload a picture please?

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…


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 :smiley:

I have no idea how to do that! :slight_smile:


and here is the code

Hi first of all thnx for the tutorial. Following the steps worked fine for me :slight_smile:. 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.

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 for example.

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