TonieToolbox 0.4.0__py3-none-any.whl → 0.4.2__py3-none-any.whl

TonieToolbox/__init__.py

@@ -2,4 +2,4 @@
 TonieToolbox - Convert audio files to Tonie box compatible format
 """
 
-__version__ = '0.4.0'
+__version__ = '0.4.2'

{tonietoolbox-0.4.0.dist-info → tonietoolbox-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TonieToolbox
-Version: 0.4.0
+Version: 0.4.2
 Summary: Convert audio files to Tonie box compatible format
 Home-page: https://github.com/Quentendo64/TonieToolbox
 Author: Quentendo64
@@ -20,6 +20,7 @@ Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Requires-Dist: protobuf<=3.19.0
+Requires-Dist: mutagen>=1.47.0
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -42,8 +43,10 @@ A Python tool for converting audio files to Tonie box compatible format (TAF - T
 - [Installation](#installation)
   - [Install from PyPI (Recommended)](#install-from-pypi-recommended)
   - [Install from Source](#install-from-source)
+  - [Using Docker](#using-docker)
 - [Usage](#usage)
   - [Basic Usage](#basic-usage)
+  - [Docker Usage](#docker-usage)
   - [Advanced Options](#advanced-options)
   - [Common Usage Examples](#common-usage-examples)
   - [Media Tags](#media-tags)
@@ -106,6 +109,32 @@ cd TonieToolbox
 pip install protobuf
 ```
 
+### Using Docker
+
+TonieToolbox is available as a Docker image, which comes with all dependencies pre-installed.
+
+#### Pull the Docker Image
+
+```
+# From Docker Hub
+docker pull quentendo64/tonietoolbox:latest
+
+# From GitHub Packages
+docker pull ghcr.io/quentendo64/tonietoolbox:latest
+```
+
+#### Build the Docker Image Locally
+
+```
+docker build -t tonietoolbox .
+```
+
+Or using docker-compose:
+
+```
+docker-compose build
+```
+
 ## Usage
 
 ### Basic Usage
@@ -162,6 +191,41 @@ By default, all generated TAF files are saved in the `.\output` directory. If yo
 tonietoolbox --recursive --output-to-source "Music/Albums"
 ```
 
+### Docker Usage
+
+Using TonieToolbox with Docker simplifies the setup process as all dependencies (FFmpeg and opus-tools) are pre-installed.
+
+**Convert a single audio file to Tonie format:**
+
+```bash
+# Use docker run
+docker run --rm -v "$(pwd)/input:/tonietoolbox/input" -v "$(pwd)/output:/tonietoolbox/output" quentendo64/tonietoolbox input/my-audio-file.mp3
+
+# Or using docker-compose
+docker-compose run --rm tonietoolbox input/my-audio-file.mp3
+```
+
+**Process folders recursively:**
+
+```bash
+# Use docker run
+docker run --rm -v "$(pwd)/input:/tonietoolbox/input" -v "$(pwd)/output:/tonietoolbox/output" quentendo64/tonietoolbox --recursive input/folder
+
+```
+
+**Advanced options with Docker:**
+
+```bash
+# Convert with custom settings
+docker run --rm -v "$(pwd)/input:/tonietoolbox/input" -v "$(pwd)/output:/tonietoolbox/output" quentendo64/tonietoolbox --recursive --use-media-tags --name-template "{album} - {artist}" --bitrate 128 input/folder
+```
+
+**Upload to TeddyCloud with Docker:**
+
+```bash
+docker run --rm -v "$(pwd)/input:/tonietoolbox/input" -v "$(pwd)/output:/tonietoolbox/output" quentendo64/tonietoolbox input/my-audio-file.mp3 --upload https://teddycloud.example.com --include-artwork
+```
+
 ### Advanced Options
 
 Run the following command to see all available options:
@@ -328,7 +392,7 @@ tonietoolbox --recursive "\Hörspiele\Die drei Fragezeichen\Folgen"
 Process a music collection with nested album folders and save TAF files alongside the source directories:
 
 ```
-tonietoolbox --recursive --output-to-source "\Hörspiele\"
+tonietoolbox --recursive --output-to-source "\Hörspiele\" 
 ```
 
 #### Automatic dependency download:

{tonietoolbox-0.4.0.dist-info → tonietoolbox-0.4.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-TonieToolbox/__init__.py,sha256=uS1mimlbtKGNhMjaW_Sp1QgltaEgqWBllV96x2O94Lc,96
+TonieToolbox/__init__.py,sha256=nXGCeCrBTSJ6dr2zymRDckNNp7HIqoxfdAdTozh7yFg,96
 TonieToolbox/__main__.py,sha256=71HjJZFNfdflCbwuL28xHpKkwLIKAXW6sVpGX9TQRII,37202
 TonieToolbox/audio_conversion.py,sha256=nV87LTzuxeJQughu-esxTq2aZq-BvaTURj-pvBqygQs,13075
 TonieToolbox/constants.py,sha256=BQ6eUNvT3eXgsz8KFYMrqpn5vRPXrp2d6folxP6H03E,4374
@@ -16,9 +16,9 @@ TonieToolbox/tonie_header.proto,sha256=WaWfwO4VrwGtscK2ujfDRKtpeBpaVPoZhI8iMmR-C
 TonieToolbox/tonie_header_pb2.py,sha256=s5bp4ULTEekgq6T61z9fDkRavyPM-3eREs20f_Pxxe8,3665
 TonieToolbox/tonies_json.py,sha256=AAYPTDTVZg4sm5AAnUKPPAifTM1iLh6Oa96ic84K2m0,20673
 TonieToolbox/version_handler.py,sha256=7Zx-pgzAUhz6jMplvNal1wHyxidodVxaNcAV0EMph5k,9778
-tonietoolbox-0.4.0.dist-info/licenses/LICENSE.md,sha256=rGoga9ZAgNco9fBapVFpWf6ri7HOBp1KRnt1uIruXMk,35190
-tonietoolbox-0.4.0.dist-info/METADATA,sha256=y7uwI3Px73oalRuO88NoTVllyj3IOfLix4-wix6IAEE,22378
-tonietoolbox-0.4.0.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-tonietoolbox-0.4.0.dist-info/entry_points.txt,sha256=oqpeyBxel7aScg35Xr4gZKnf486S5KW9okqeBwyJxxc,60
-tonietoolbox-0.4.0.dist-info/top_level.txt,sha256=Wkkm-2p7I3ENfS7ZbYtYUB2g-xwHrXVlERHfonsOPuE,13
-tonietoolbox-0.4.0.dist-info/RECORD,,
+tonietoolbox-0.4.2.dist-info/licenses/LICENSE.md,sha256=rGoga9ZAgNco9fBapVFpWf6ri7HOBp1KRnt1uIruXMk,35190
+tonietoolbox-0.4.2.dist-info/METADATA,sha256=j46zRD7ZTIkOIh3MlgYmON0-lKUUx62dBOZn2QzY2DU,24105
+tonietoolbox-0.4.2.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+tonietoolbox-0.4.2.dist-info/entry_points.txt,sha256=oqpeyBxel7aScg35Xr4gZKnf486S5KW9okqeBwyJxxc,60
+tonietoolbox-0.4.2.dist-info/top_level.txt,sha256=Wkkm-2p7I3ENfS7ZbYtYUB2g-xwHrXVlERHfonsOPuE,13
+tonietoolbox-0.4.2.dist-info/RECORD,,