Skip to content

Welcome to TonieToolbox

Documentation Work in Progress

This documentation is being updated for TonieToolbox v1.0.0a1. Some sections may contain outdated information or be incomplete. We're actively working on updating all pages to reflect the new architecture and features.

TonieToolbox is a powerful, user-friendly toolkit for converting various audio formats into Tonie-compatible TAF format and seamlessly integrating with TeddyCloud servers.

Merry Christmas 🎄🎉

TonieToolbox Christmas

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.

What's New in v1.0.0a1 ✨

The first alpha release of the 1.0 series brings a complete architectural overhaul:

New Features

  • 🏗️ Clean Architecture - Complete codebase refactoring with event-driven design
  • 🔌 Plugin System - Extensible plugin marketplace with official and community plugins
  • 🎨 Modern GUI - New PyQt6 interface with TAF player, playlist management, and themes
  • 🖥️ Enhanced Desktop Integration - Improved context menu support across platforms
  • ⚡ Better Performance - Async operations, background processing, improved threading

Key Features

  • 🔄 Audio Conversion - Convert MP3, FLAC, WAV, OGG, and more to TAF format
  • 📁 Batch Processing - Handle entire music libraries recursively
  • 🎨 Modern GUI - PyQt6 interface with TAF player and plugin support
  • ☁️ 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
  • 🔌 Plugin Marketplace - Extend functionality with community plugins
  • 🐳 Docker Support - Cross-platform containerized execution

Common Use Cases

Convert and organize entire audiobook series with proper metadata and artwork.

tonietoolbox --recursive --use-media-tags --name-template "{series} - {title}" audiobooks/

Process music collections with intelligent organization by artist and album.

tonietoolbox --recursive --output-to-template "{artist}/{album}" music/

Create custom Tonie content for kids with artwork and proper naming.

tonietoolbox stories/ --upload https://teddycloud.local --include-artwork

Community & Support

Legal Notice

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.