ttmp32gme

Cross-platform tool to convert MP3/audio files into TipToi GME files playable on the TipToi pen. Generates printable control sheets with OID codes for music/audiobook playback control.

Inspired by the Windows tool ttaudio, powered by tttool.

Features

• Convert MP3/OGG to TipToi GME format
• Auto-generate printable control sheets with OID codes
• Flexible print layouts (list, tiles, CD booklet)
• Auto-extract ID3 tags and cover images
• Direct copy to TipToi pen when connected
• Cross-platform: Windows, macOS, Linux

Quick Start

Windows/macOS: Download executable from releases, run, open http://localhost:10020

Linux (Python):

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

Podman (docker alternative):

podman run -d --rm --publish 8080:8080 \
  --volume ~/.ttmp32gme:/var/lib/ttmp32gme \
  --name ttmp32gme thawn/ttmp32gme:latest

See Installation Guide for detailed instructions and options.

Basic Usage

1. Upload: Add MP3/OGG files (one album at a time)
2. Configure: Edit album info, select OID number, choose player mode
3. Create GME: Generate TipToi-compatible files
4. Print: Print control sheets with OID codes
5. Copy: Transfer GME files to connected TipToi pen

See Usage Guide for detailed instructions.

Command Line

ttmp32gme --port 8080              # Custom port
ttmp32gme --host 0.0.0.0           # Network access
ttmp32gme --library /path/to/lib   # Custom library
ttmp32gme -v                       # Increase verbosity (-v for INFO, -vv for DEBUG)
ttmp32gme --version                # Show version
ttmp32gme --help                   # Show all options

Print Troubleshooting

OID codes not recognized?

1. Print at 100% scale (critical!)
2. Use 1200 DPI or higher
3. Test with OID table
4. If test fails: printer issue (try different printer/paper)
5. If test works: increase pixels per dot (3-4) in print config

See Print Configuration and Troubleshooting for detailed help.

Screenshots

Print Layouts

List: Full details, 1-2 albums per page

Tiles: Compact grid, many albums per page

CD Booklet: Fits standard CD cases

Print Configuration

Documentation

Comprehensive documentation available here.

• Getting Started - Quick introduction
• Installation - Platform-specific instructions
• Usage Guide - Complete feature guide
• Print Configuration - Print setup and troubleshooting
• Troubleshooting - Common problems and solutions
• Development - Architecture and contribution guide
• API Reference - API documentation

Build documentation locally:

uv pip install sphinx sphinx-rtd-theme myst-parser sphinx-autodoc-typehints
# Or: pip install sphinx sphinx-rtd-theme myst-parser sphinx-autodoc-typehints
cd docs/ && make html
# Open docs/_build/html/index.html

Resources

• tttool - TipToi tool and manual
• ttaudio - Windows alternative
• TipToi Printing Guide

Testing

# Unit tests
pytest tests/unit/ -v

# All tests (includes E2E with Selenium)
pytest tests/ -v

# With coverage
pytest --cov=ttmp32gme

See Development Guide for details.

Contributing

Contributions welcome! See Contributing Guide for workflow and guidelines.

License

See LICENSE file.