top of page

How to get Tuxemon up and running on your Gameshell

  • Writer: Hal
    Hal
  • Sep 4, 2019
  • 1 min read

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!

15 Comments


Ruth Sanders
Ruth Sanders
3 days ago

Thanks for the clear guide on getting Tuxemon up and running on your GameShell — it’s great to see practical, step-by-step advice that makes setup easy and fun, and while gaming and tech might seem worlds apart, it’s always interesting to see how innovation connects fields, from indie hardware projects to aerospace industry trends that push the boundaries of what technology can do.

Like

Allen Barry
Allen Barry
Dec 02, 2025

I appreciate the clear steps, especially about editing that config file for the resolution. Going to try this later! Hope it's not as nail-biting as trying to get a high score on Electron Dash , that rush game is intense!

Like

Tornull Projec
Tornull Projec
Dec 02, 2025

Snow Rider 2 delivers a thrilling experience with ever-changing terrain, engaging sled unlocks, and fast-paced skiing mechanics that will keep you coming back day after day.

Edited
Like

pricots sistera
pricots sistera
Nov 13, 2025

Bitlife is a big picture painted by small choices. Players go through each stage, each relationship, each success and failure, only to realize that the true value of life is not in the end point, but in each moment lived.

Like

simba lamka
simba lamka
Nov 03, 2025

99 nights in the forest places you in a tense environment where every sound, shadow, and movement matters.

Like
bottom of page