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!

18 Comments


Trump threatens YRKKH Written Update new tariffs on European allies over Greenland until deal reached, as thousands protest.


Like

Thanks for the detailed guide, Hal! I followed your steps and got Tuxemon running on my Gameshell without major issues. The instructions on setting up the resolution and large_gui really helped, as my first launch looked a bit off. While tinkering with games and tech, I also explore creative AI tools for storytelling and character design. One interesting resource I’ve been using is the Trans AI Character section on https://lovescape.com/categories/transwoman Lovescape—it lets you experiment with character interactions and scenarios, which pairs surprisingly well with the gaming and development side of things. Overall, your guide made the setup much smoother!

Like

Great insights on growth hack techniques for SaaS companies — scaling smartly often means balancing rapid feature delivery with strong quality and trust, so customers feel confident using your product. In a related area of development practice, understanding manual secure code review remains important, because having human-led review for security and logic helps catch subtle issues that automated tools can miss; combining thoughtful growth tactics with solid quality practices makes SaaS products both competitive and reliable.

Like

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
bottom of page