top of page
  • Writer's pictureHal

How to get Tuxemon up and running on your Gameshell

Updated: Sep 6, 2019

This article is from HERE


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:

  • WiFi connection

  • Device to ssh from

  • Gameshell


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 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!

171 views0 comments

Recent Posts

See All
bottom of page