TonieToolbox 0.2.3__py3-none-any.whl → 0.3.0__py3-none-any.whl

{tonietoolbox-0.2.3.dist-info → tonietoolbox-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TonieToolbox
-Version: 0.2.3
+Version: 0.3.0
 Summary: Convert audio files to Tonie box compatible format
 Home-page: https://github.com/Quentendo64/TonieToolbox
 Author: Quentendo64
@@ -47,12 +47,14 @@ A Python tool for converting audio files to Tonie box compatible format (TAF - T
   - [Advanced Options](#advanced-options)
   - [Common Usage Examples](#common-usage-examples)
   - [Media Tags](#media-tags)
+  - [TeddyCloud Upload](#teddycloud-upload)
 - [Technical Details](#technical-details)
   - [TAF File Structure](#taf-tonie-audio-format-file-structure)
   - [File Analysis](#file-analysis)
   - [File Comparison](#file-comparison)
 - [Related Projects](#related-projects)
 - [Contributing](#contributing)
+- [Legal Notice](#legal-notice)
 
 ## Overview
 
@@ -69,6 +71,8 @@ The tool provides several capabilities:
 - Compare two TAF files for debugging differences
 - Support various input formats through FFmpeg conversion
 - Extract and use audio media tags (ID3, Vorbis Comments, etc.) for better file naming
+- Upload Tonie files directly to a TeddyCloud server
+- Automatically upload cover artwork alongside Tonie files
 
 ## Requirements
 
@@ -167,7 +171,11 @@ tonietoolbox -h
 
 Output:
 ```
-usage: TonieToolbox.py [-h] [-v] [-t TIMESTAMP] [-f FFMPEG] [-o OPUSENC] 
+usage: TonieToolbox.py [-h] [-v] [--upload URL] [--include-artwork] [--get-tags URL] 
+                    [--ignore-ssl-verify] [--special-folder FOLDER] [--path PATH]
+                    [--show-progress] [--connection-timeout SECONDS]
+                    [--read-timeout SECONDS] [--max-retries RETRIES]
+                    [--retry-delay SECONDS] [-t TIMESTAMP] [-f FFMPEG] [-o OPUSENC]
                     [-b BITRATE] [-c] [-a TAG] [-n] [-i] [-s] [-r] [-O]
                     [-A] [-k] [-C FILE2] [-D] [-m] [--name-template TEMPLATE]
                     [--show-tags] [-d] [-T] [-q] [-Q]
@@ -179,6 +187,24 @@ positional arguments:
   SOURCE                input file or directory or a file list (.lst)
   TARGET                the output file name (default: ---ID---)
 
+TeddyCloud Options:
+  --upload URL          Upload to TeddyCloud instance (e.g., https://teddycloud.example.com). Supports .taf, .jpg, .jpeg, .png files.
+  --include-artwork     Upload cover artwork image alongside the Tonie file when using --upload
+  --get-tags URL        Get available tags from TeddyCloud instance
+  --ignore-ssl-verify   Ignore SSL certificate verification (for self-signed certificates)
+  --special-folder FOLDER
+                        Special folder to upload to (currently only "library" is supported)
+  --path PATH           Path where to write the file on TeddyCloud server
+  --show-progress       Show progress bar during file upload (default: enabled)
+  --connection-timeout SECONDS
+                        Connection timeout in seconds (default: 10)
+  --read-timeout SECONDS
+                        Read timeout in seconds (default: 300)
+  --max-retries RETRIES
+                        Maximum number of retry attempts (default: 3)
+  --retry-delay SECONDS
+                        Delay between retry attempts in seconds (default: 5)
+
 optional arguments:
   -h, --help            show this help message and exit
   -v, --version         show program version and exit
@@ -325,6 +351,65 @@ This will attempt to use the album information from the audio files for naming t
 tonietoolbox --recursive --use-media-tags --name-template "{date} - {album} ({artist})" "Music/Collection/"
 ```
 
+### TeddyCloud Upload
+
+TonieToolbox can upload files directly to a TeddyCloud server, which is an alternative to the official Tonie cloud for managing custom Tonies.
+
+#### Upload a Tonie file to TeddyCloud:
+
+```
+tonietoolbox --upload https://teddycloud.example.com my_tonie.taf
+```
+
+This will upload the specified Tonie file to the TeddyCloud server.
+
+#### Upload a newly created Tonie file:
+
+You can combine conversion and upload in a single command:
+
+```
+tonietoolbox input.mp3 --upload https://teddycloud.example.com
+```
+
+This will convert the input file to TAF format and then upload it to the TeddyCloud server.
+
+#### Upload with custom path:
+
+```
+tonietoolbox my_tonie.taf --upload https://teddycloud.example.com --path "/custom_audio"
+The path needs to be existing in the TeddyCloud Library.
+```
+
+#### Upload with artwork:
+
+TonieToolbox can automatically find and upload cover artwork alongside your Tonie files:
+
+```
+tonietoolbox my_tonie.taf --upload https://teddycloud.example.com --include-artwork
+```
+
+This will:
+1. Look for cover images (like "cover.jpg", "artwork.png", etc.) in the source directory
+2. If no cover image is found, attempt to extract embedded artwork from the audio files
+3. Upload the artwork to the "/custom_img" directory on the TeddyCloud server
+4. The artwork will be uploaded with the same filename as the Tonie file for easier association
+
+#### Recursive processing with uploads:
+
+```
+tonietoolbox --recursive "Music/Albums" --upload https://teddycloud.example.com --include-artwork
+```
+
+This will process all folders recursively, create TAF files, and upload both the TAF files and their cover artwork to the TeddyCloud server.
+
+#### Upload with SSL certificate verification disabled:
+
+```
+tonietoolbox my_tonie.taf --upload https://teddycloud.example.com --ignore-ssl-verify
+```
+
+Use this option if the TeddyCloud server uses a self-signed certificate.
+
 ## Technical Details
 
 ### TAF (Tonie Audio Format) File Structure
@@ -404,3 +489,15 @@ This project is inspired by and builds upon the work of other Tonie-related open
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Legal Notice
+
+This project is an independent, community-driven effort created for educational and personal use purposes.
+
+- tonies®, toniebox®, Hörfigur® are registered trademarks of [tonies GmbH](https://tonies.com).
+- This project is not affiliated with, endorsed by, or connected to tonies GmbH in any way.
+- TonieToolbox is provided "as is" without warranty of any kind, either express or implied.
+- Users are responsible for ensuring their usage complies with all applicable copyright and intellectual property laws.
+- This tool is intended for personal use with legally owned content only.
+
+By using TonieToolbox, you acknowledge that the authors of this software take no responsibility for any potential misuse or any damages that might result from the use of this software.

{tonietoolbox-0.2.3.dist-info → tonietoolbox-0.3.0.dist-info}/RECORD

@@ -1,22 +1,23 @@
-TonieToolbox/__init__.py,sha256=mRuWBCYSLc6tAHyVDd70qM5LHgWH7R8ClFbFfILlEso,96
-TonieToolbox/__main__.py,sha256=Otltlkl9Cd36BYs5_23ufCkdxguFFVzuVDwSvWDSPfI,17078
+TonieToolbox/__init__.py,sha256=1DGgQLdpAkK84simgtWndHZBKXuXCb-jPnMK_wvNOWc,96
+TonieToolbox/__main__.py,sha256=Y6-gjbjNbKhpEvV6wi8BpZSUXXezxfgZT5g8HfMeO4E,34078
 TonieToolbox/audio_conversion.py,sha256=ra72qsE8j2GEP_4kqDT9m6aKlnnREZhZAlpf7y83pA0,11202
 TonieToolbox/constants.py,sha256=QQWQpnCI65GByLlXLOkt2n8nALLu4m6BWp0zuhI3M04,2021
-TonieToolbox/dependency_manager.py,sha256=dRy8JxV3Dv1x8uWIXMonU0ArnCRknI1rkrj8MkJcyl4,27916
+TonieToolbox/dependency_manager.py,sha256=EvVUO4T1CrhUXlrVk9HBgCRDER3b1BRNdgkZLSpCTho,27921
 TonieToolbox/filename_generator.py,sha256=RqQHyGTKakuWR01yMSnFVMU_HfLw3rqFxKhXNIHdTlg,3441
 TonieToolbox/logger.py,sha256=Up9fBVkOZwkY61_645bX4tienCpyVSkap-FeTV0v730,1441
-TonieToolbox/media_tags.py,sha256=T8osaU101iGC43NaMbbHD8mwNh-dGa_uPj7IPlhMIno,16091
+TonieToolbox/media_tags.py,sha256=XzCuBcaqBPiSCBip8rWrJ3hTHDwEEN1flyPywM7CMsg,22250
 TonieToolbox/ogg_page.py,sha256=-ViaIRBgh5ayfwmyplL8QmmRr5P36X8W0DdHkSFUYUU,21948
 TonieToolbox/opus_packet.py,sha256=OcHXEe3I_K4mWPUD55prpG42sZxJsEeAxqSbFxBmb0c,7895
 TonieToolbox/recursive_processor.py,sha256=m70-oJ4MRXvI9OMy14sC9UsQIxwVEnEoA3hhLGdHhL4,13457
+TonieToolbox/teddycloud.py,sha256=YRgOU3f1qVDSoV05mCCDHb4pd00aI_oD8HViIotvez4,23366
 TonieToolbox/tonie_analysis.py,sha256=kp4Wx4cTDddtF2AlS6IX4xs1vQ-mpZ0gsAy4-UdRAAM,23287
 TonieToolbox/tonie_file.py,sha256=vY0s8X4ln35ZXpdpGmBcIxgpTJAjduiVvBh34WObyrw,19647
 TonieToolbox/tonie_header.proto,sha256=WaWfwO4VrwGtscK2ujfDRKtpeBpaVPoZhI8iMmR-C0U,202
 TonieToolbox/tonie_header_pb2.py,sha256=s5bp4ULTEekgq6T61z9fDkRavyPM-3eREs20f_Pxxe8,3665
 TonieToolbox/version_handler.py,sha256=7Zx-pgzAUhz6jMplvNal1wHyxidodVxaNcAV0EMph5k,9778
-tonietoolbox-0.2.3.dist-info/licenses/LICENSE.md,sha256=rGoga9ZAgNco9fBapVFpWf6ri7HOBp1KRnt1uIruXMk,35190
-tonietoolbox-0.2.3.dist-info/METADATA,sha256=2LiL3ouh2jIdA3CD7i8nSZY-PStXbhkT8GNTZVvpgrM,12444
-tonietoolbox-0.2.3.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-tonietoolbox-0.2.3.dist-info/entry_points.txt,sha256=oqpeyBxel7aScg35Xr4gZKnf486S5KW9okqeBwyJxxc,60
-tonietoolbox-0.2.3.dist-info/top_level.txt,sha256=Wkkm-2p7I3ENfS7ZbYtYUB2g-xwHrXVlERHfonsOPuE,13
-tonietoolbox-0.2.3.dist-info/RECORD,,
+tonietoolbox-0.3.0.dist-info/licenses/LICENSE.md,sha256=rGoga9ZAgNco9fBapVFpWf6ri7HOBp1KRnt1uIruXMk,35190
+tonietoolbox-0.3.0.dist-info/METADATA,sha256=17k_CP3FXVhfO60HrS3CWP1bfN-pGNwNFwtfd9QzQj4,16695
+tonietoolbox-0.3.0.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+tonietoolbox-0.3.0.dist-info/entry_points.txt,sha256=oqpeyBxel7aScg35Xr4gZKnf486S5KW9okqeBwyJxxc,60
+tonietoolbox-0.3.0.dist-info/top_level.txt,sha256=Wkkm-2p7I3ENfS7ZbYtYUB2g-xwHrXVlERHfonsOPuE,13
+tonietoolbox-0.3.0.dist-info/RECORD,,