TonUINO Writer for Flipper Zero

March 12, 2026 · View on GitHub

NFC card writer application for TonUINO audio boxes. Create and manage NFC cards for the TonUINO DIY music player system.

Features

✅ Write TonUINO Cards - Configure NFC cards with folder, mode, and special settings
✅ Read TonUINO Cards - Read and display existing card configurations
✅ Rapid Write Mode - Quickly write multiple cards with adjustable settings
✅ Cancelable Operations - Cancel read/write operations at any time with dedicated button
✅ Card Preview - View card configuration before writing
✅ Menu Position Memory - Returns to your last selected menu item
✅ All 11 Play Modes - Full TonUINO mode support

This app allows you to create and write TonUINO-compatible NFC cards directly from your Flipper Zero device. TonUINO cards use a specific 16-byte format to control playback modes and folder selection on TonUINO audio boxes.

Card Format

Each TonUINO card contains 16 bytes:

Bytes 0-3: Box identifier (always 13 37 B3 47)
Byte 4: Version (currently 0x02)
Byte 5: Folder number (1-99, hex 0x01-0x63)
Byte 6: Playback mode (see modes below)
Byte 7: Special value 1 (for von-bis modes)
Byte 8: Special value 2 (for von-bis modes)
Bytes 9-15: Reserved (set to 0x00)

Playback Modes

Hoerspiel (Random) - Plays a random file from the folder
Album (Complete) - Plays the entire folder in order
Party (Shuffle) - Plays files in random order
Einzel (Single) - Plays a specific file from the folder
Hoerbuch (Progress) - Plays folder and remembers progress
Admin - Admin functions
Hoerspiel Von-Bis - Random file from a range (uses Special values)
Album Von-Bis - All files from a range (uses Special values)
Party Von-Bis - Shuffled files from a range (uses Special values)
Hoerbuch Einzel - Single track with progress tracking
Repeat Last - Repeats the last card/shortcut

Building

Clone the Flipper Zero firmware repository:

git clone --recursive https://github.com/flipperdevices/flipperzero-firmware.git
cd flipperzero-firmware

Copy this application to applications_user/tonuino_writer/:

cp -r /path/to/tonuino-flipper-zero/* applications_user/tonuino_writer/

Build the application:
```
./fbt fap_tonuino_writer
```
Install to your Flipper Zero:
```
./fbt launch_app APPSRC=tonuino_writer
```

Usage

Launch from Apps → NFC → TonUINO Writer. The main menu offers:

Set Folder - Choose folder number (1-99)
Set Mode - Select from 11 playback modes
Set Special 1 - First special value (0-255, for von-bis modes)
Set Special 2 - Second special value (0-255, for von-bis modes)
View Card - Preview current configuration
Read Card - Read existing TonUINO card
Write Card - Write configuration to NFC card
Rapid Write - Quick multi-card writing mode
About - App version and information

Writing a Card

Configure your card using Set Folder, Set Mode, and optional Special values
Select "View Card" to preview (optional)
Select "Write Card"
Place MIFARE Classic card on back of Flipper
Press "Cancel" button (left) to abort at any time
Wait for success confirmation

Reading a Card

Select "Read Card" from main menu
Place TonUINO card on back of Flipper
Press "Cancel" button (left) to abort
View the card configuration on screen

Rapid Write Mode

Perfect for creating multiple cards with the same base configuration:

Select "Rapid Write" from main menu
Up/Down - Toggle between Folder and Mode selection (highlighted in brackets)
Left/Right - Adjust selected value (wraps around)
OK - Write current configuration to card
Back - Return to main menu

Status messages appear at the bottom showing write results.