A powerful toolkit for converting audio files to Tonie-compatible TAF format and integrating with TeddyCloud.

As a special holiday gift to myself, I am proud to announce the alpha release of TonieToolbox v1.0.0a1! This is a complete rewrite of the TonieToolbox.

• 🎨 New GUI Interface - User-friendly graphical interface
• 🖥️ Enhanced Desktop Integration - Context menu support for Windows and Linux
• 🔍 Code Completion - Shell completion scripts for bash, zsh, pwsh and fish
• 🏗️ New Architecture - Complete new codebase HOLY MOLY
• ⚙️ Centralized Configuration - Unified settings management

This is an alpha release of TonieToolbox v1.0.0a1. While core functionalities such as audio conversion and TeddyCloud upload have been tested, some advanced features may still be under development or require further testing. Users are encouraged to report any issues or feedback to help improve the TonieToolbox.

pip install tonietoolbox
tonietoolbox --gui

Simply drag and drop your audio files!

# Convert a single file
tonietoolbox input.mp3

# Convert entire folders
tonietoolbox --recursive /path/to/audio/folders

# Upload to TeddyCloud
tonietoolbox input.mp3 --upload https://teddycloud.local --include-artwork

• 🔄 Audio Conversion - Convert MP3, FLAC, WAV, and more to TAF format
• 📁 Batch Processing - Handle entire music libraries recursively
• 🎨 GUI Interface - Drag-and-drop simplicity with visual feedback
• ☁️ TeddyCloud Integration - Direct upload with artwork support
• 🏷️ Smart Tagging - Use audio metadata for intelligent file naming
• 🖥️ Desktop Integration - Right-click context menus across platforms
• 🔍 Analysis Tools - Validate, split, and compare TAF files
• 🐳 Docker Support - Cross-platform containerized execution

pip install tonietoolbox

docker pull quentendo64/tonietoolbox:latest

git clone https://github.com/TonieToolbox/TonieToolbox.git
cd TonieToolbox
pip install -e .

• 📚 Audiobook Collections - Convert and organize audiobook series
• 🎵 Music Libraries - Process entire music collections with metadata
• 🎭 Children's Stories - Create custom Tonie content for kids
• 🎪 Podcast Archives - Convert podcast episodes for offline listening

• Python 3.12+
• FFmpeg (auto-downloadable with --auto-download)

• 🐛 Issues - Bug reports and feature requests
• 💬 Discussions - Community Q&A and ideas
• 📖 Documentation - Complete user guide

This project is independent and not affiliated with tonies GmbH. tonies®, toniebox®, and related trademarks belong to tonies GmbH. Use responsibly with legally owned content only.

• Parrot Icon by Freepik - Flaticon
• Inspired by opus2tonie and the teddycloud projects