Skip to content

Installation Guide

The PixelRoot32 Tilemap Editor can be run directly from source or as a standalone executable on Windows.

1. Requirements

  • Python 3.13+ (if running from source).
  • Windows 10/11 (recommended).

2. Install from Source

2.1 Clone the Repository

git clone https://github.com/Gperez88/PixelRoot32-Tilemap-Editor.git
cd PixelRoot32-Tilemap-Editor

2.2 Install Dependencies

The editor uses several Python libraries for the GUI and image processing:

pip install ttkbootstrap pillow jinja2

2.3 Run the Editor

python main.py

3. Standalone Executable (Windows)

For a more convenient experience, you can use the pre-compiled version:

  1. Go to the Releases section of the repository.
  2. Download the latest PixelRoot32-Editor-win64.zip.
  3. Extract the contents to a folder.
  4. Run PixelRoot32-Editor.exe.

Note: No Python installation is required to run the standalone executable.

4. Building your own Executable

If you want to package the editor yourself:

  1. Install PyInstaller:
pip install pyinstaller
  1. Run the build command using the provided .spec file:
pyinstaller pixelroot32_editor.spec
  1. The executable will be available in the dist/ folder.