Installation

Windows and macOS

Download pre-built executables from releases page, extract, and run. Open http://localhost:10020 in browser.

⚠️ Security Warning: The executables are unsigned as code signing certificates are not available. Your OS will show security warnings on first run.

Requirements:

Chrome or Chromium browser (optional, for PDF generation) - Download Chrome
- Note: Chromium is only needed if printing directly from your browser doesn’t work. You can print control sheets directly from most browsers without Chromium.

Installation steps:

Download the appropriate ZIP file for your platform:
- ttmp32gme-windows.zip for Windows
- ttmp32gme-macos.zip for macOS
Extract the ZIP file to a location of your choice
Run the executable:
- Windows: Double-click ttmp32gme.exe or run from command prompt
  - If Windows SmartScreen blocks it: Click “More info” → “Run anyway” (details)
- macOS: Right-click ttmp32gme.app → “Open” (first time only to bypass Gatekeeper)
  - If blocked: System Settings → Privacy & Security → scroll down → “Open Anyway” (details)
  - A status window will appear with:
    - Server URL and status
    - “Open Browser” button to launch the web interface
    - “Show Logs” button to view server logs
    - “Stop Server” button to shut down the application
  - Close the status window to shut down the server
Open your browser to http://localhost:10020

The executable includes all necessary dependencies (tttool, ffmpeg) except Chrome/Chromium which should be installed separately.

Linux

Podman (Recommended)

Pre-built image:

podman run -d --rm \
  --publish 8080:8080 \
  --volume ~/.ttmp32gme:/var/lib/ttmp32gme \
  --volume /media/${USER}/tiptoi:/mnt/tiptoi \
  --name ttmp32gme thawn/ttmp32gme:latest

Podman Compose: Download docker-compose.yml, run podman-compose up -d (the docker-compose.yml file format is compatible with podman-compose)

Python

git clone https://github.com/thawn/ttmp32gme.git && cd ttmp32gme
uv pip install -e .  # Recommended; or: pip install -e .

Install tttool: See tttool installation

Optional (OGG support): sudo apt-get install ffmpeg

Run: ttmp32gme or python -m ttmp32gme.ttmp32gme

Command Line Options

ttmp32gme --port 8080                      # Custom port
ttmp32gme --host 0.0.0.0                   # Network access
ttmp32gme --database /path/to/db.sqlite    # Custom database
ttmp32gme --library /path/to/library       # Custom library
ttmp32gme -v                               # Increase verbosity (-v for INFO, -vv for DEBUG)
ttmp32gme --version                        # Show version

Verification

ttmp32gme --version
curl http://localhost:10020/  # Should return HTML