Usage Guide

Web Interface

Access at http://localhost:10020 after starting ttmp32gme (or http://localhost:8080 if using Docker/Podman).

Pages:

Upload - Add MP3/OGG files and cover images
Library - Manage albums, create GME files
Print - Configure and print control sheets
Config - Application settings

Workflow

1. Upload Files

Go to Upload page
Add MP3/OGG files (one album at a time)
Optionally add cover image (JPEG/PNG)
Upload - metadata extracted automatically

2. Configure Album

On Library page:

Review/edit album info (title, artist, tracks)
Choose OID number (1-999, must be unique)
Select player mode: Music or Audiobook (TipToi)

3. Create GME

Click “Create GME” button
Wait for conversion (1-5 minutes)
GME file created in library

4. Print Control Sheets

Select albums (checkboxes)
Click “Print Selected”
Configure layout (gear icon)
Print at 100% scale, high quality
See Print Configuration for details

5. Copy to TipToi

Connect TipToi pen
Select albums in library
Click “Copy selected to TipToi”
Wait for completion

Player Modes

Music: Play all tracks, then stop

TipToi: Play all tracks, repeat from beginning when finished

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

Tips

Upload one album at a time
Use unique OID numbers
Include cover images
Print at 1200 DPI
Backup ~/.ttmp32gme/ directory (see Migration Guide)