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

TonieToolbox/__init__.py

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

TonieToolbox/__main__.py

@@ -19,6 +19,7 @@ from .version_handler import check_for_updates, clear_version_cache
 from .recursive_processor import process_recursive_folders
 from .media_tags import is_available as is_media_tags_available, ensure_mutagen
 from .teddycloud import upload_to_teddycloud, get_tags_from_teddycloud, get_file_paths
+from .tonies_json import fetch_and_update_tonies_json
 
 def main():
     """Entry point for the TonieToolbox application."""
@@ -50,7 +51,9 @@ def main():
                        help='Maximum number of retry attempts (default: 3)')
     teddycloud_group.add_argument('--retry-delay', type=int, metavar='SECONDS', default=5,
                        help='Delay between retry attempts in seconds (default: 5)')
-    
+    teddycloud_group.add_argument('--create-custom-json', action='store_true',
+                       help='Fetch and update custom Tonies JSON data')
+
     parser.add_argument('input_filename', metavar='SOURCE', type=str, nargs='?',
                         help='input file or directory or a file list (.lst)')
     parser.add_argument('output_filename', metavar='TARGET', nargs='?', type=str,
@@ -104,6 +107,8 @@ def main():
     log_level_group.add_argument('-T', '--trace', action='store_true', help='Enable trace logging (very verbose)')
     log_level_group.add_argument('-q', '--quiet', action='store_true', help='Show only warnings and errors')
     log_level_group.add_argument('-Q', '--silent', action='store_true', help='Show only errors')
+    log_group.add_argument('--log-file', action='store_true', default=False,
+                       help='Save logs to a timestamped file in .tonietoolbox folder')
 
     args = parser.parse_args()
     
@@ -111,6 +116,7 @@ def main():
     if args.input_filename is None and not (args.get_tags or args.upload):
         parser.error("the following arguments are required: SOURCE")
         
+    # Set up the logging level
     if args.trace:
         from .logger import TRACE
         log_level = TRACE
@@ -123,12 +129,15 @@ def main():
     else:
         log_level = logging.INFO
     
-    setup_logging(log_level)
+    setup_logging(log_level, log_to_file=args.log_file)
     logger = get_logger('main')
     logger.debug("Starting TonieToolbox v%s with log level: %s", __version__, logging.getLevelName(log_level))
     
+    # Log the command-line arguments at trace level for debugging purposes
+    logger.log(logging.DEBUG - 1, "Command-line arguments: %s", vars(args))
 
     if args.clear_version_cache:
+        logger.log(logging.DEBUG - 1, "Clearing version cache")
         if clear_version_cache():
             logger.info("Version cache cleared successfully")
         else:
@@ -141,18 +150,24 @@ def main():
             force_refresh=args.force_refresh_cache
         )
         
+        logger.log(logging.DEBUG - 1, "Update check results: is_latest=%s, latest_version=%s, update_confirmed=%s", 
+                   is_latest, latest_version, update_confirmed)
+        
         if not is_latest and not update_confirmed and not (args.silent or args.quiet):
             logger.info("Update available but user chose to continue without updating.")
 
     # Handle get-tags from TeddyCloud if requested
     if args.get_tags:
+        logger.debug("Getting tags from TeddyCloud: %s", args.get_tags)
         teddycloud_url = args.get_tags
         success = get_tags_from_teddycloud(teddycloud_url, args.ignore_ssl_verify)
+        logger.log(logging.DEBUG - 1, "Exiting with code %d", 0 if success else 1)
         sys.exit(0 if success else 1)
     
     # Handle upload to TeddyCloud if requested
     if args.upload:
         teddycloud_url = args.upload
+        logger.debug("Upload to TeddyCloud requested: %s", teddycloud_url)
         
         if not args.input_filename:
             logger.error("Missing input file for --upload. Provide a file path as SOURCE argument.")
@@ -162,6 +177,7 @@ def main():
         if os.path.exists(args.input_filename) and (args.input_filename.lower().endswith('.taf') or 
                                                   args.input_filename.lower().endswith(('.jpg', '.jpeg', '.png'))):
             # Direct upload of existing TAF or image file
+            logger.debug("Direct upload of existing TAF or image file detected")
             # Use get_file_paths to handle Windows backslashes and resolve the paths correctly
             file_paths = get_file_paths(args.input_filename)
             
@@ -191,10 +207,12 @@ def main():
                 else:
                     logger.info("Successfully uploaded %s to TeddyCloud", file_path)
             
+            logger.log(logging.DEBUG - 1, "Exiting after direct upload with code 0")
             sys.exit(0)
             
         # If we get here, it's not a TAF or image file, so continue with normal processing
         # which will convert the input files and upload the result later
+        logger.debug("Input is not a direct upload file, continuing with conversion workflow")
         pass
 
     ffmpeg_binary = args.ffmpeg
@@ -614,5 +632,49 @@ def main():
                 else:
                     logger.warning("No artwork found to upload")
 
+    # Handle create-custom-json option
+    if args.create_custom_json and args.upload:
+        teddycloud_url = args.upload
+        artwork_url = None
+        
+        # If artwork was uploaded, construct its URL for the JSON
+        if args.include_artwork:
+            taf_basename = os.path.splitext(os.path.basename(out_filename))[0]
+            artwork_ext = None
+            
+            # Try to determine the artwork extension by checking what was uploaded
+            source_dir = os.path.dirname(files[0]) if files else None
+            if source_dir:
+                from .media_tags import find_cover_image
+                artwork_path = find_cover_image(source_dir)
+                if artwork_path:
+                    artwork_ext = os.path.splitext(artwork_path)[1]
+            
+            # If we couldn't determine extension from a found image, default to .jpg
+            if not artwork_ext:
+                artwork_ext = ".jpg"
+                
+            # Construct the URL for the artwork based on TeddyCloud structure
+            artwork_path = args.path or "/custom_img"
+            if not artwork_path.endswith('/'):
+                artwork_path += '/'
+                
+            artwork_url = f"{teddycloud_url}{artwork_path}{taf_basename}{artwork_ext}"
+            logger.debug("Using artwork URL: %s", artwork_url)
+        
+        logger.info("Fetching and updating custom Tonies JSON data")
+        success = fetch_and_update_tonies_json(
+            teddycloud_url, 
+            args.ignore_ssl_verify,
+            out_filename, 
+            files, 
+            artwork_url
+        )
+        
+        if success:
+            logger.info("Successfully updated custom Tonies JSON data")
+        else:
+            logger.warning("Failed to update custom Tonies JSON data")
+
 if __name__ == "__main__":
     main()

TonieToolbox/audio_conversion.py

@@ -28,6 +28,9 @@ def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitra
     Returns:
         tuple: (file handle, temp_file_path) or (file handle, None) if keep_temp is False
     """
+    logger.trace("Entering get_opus_tempfile(ffmpeg_binary=%s, opus_binary=%s, filename=%s, bitrate=%d, vbr=%s, keep_temp=%s, auto_download=%s)",
+                ffmpeg_binary, opus_binary, filename, bitrate, vbr, keep_temp, auto_download)
+    
     logger.debug("Converting %s to Opus format (bitrate: %d kbps, vbr: %s)", filename, bitrate, vbr)
     
     if ffmpeg_binary is None:
@@ -59,18 +62,19 @@ def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitra
         
         logger.debug("Starting FFmpeg process")
         try:
-            ffmpeg_process = subprocess.Popen(
-                [ffmpeg_binary, "-hide_banner", "-loglevel", "warning", "-i", filename, "-f", "wav",
-                 "-ar", "48000", "-"], stdout=subprocess.PIPE)
+            ffmpeg_cmd = [ffmpeg_binary, "-hide_banner", "-loglevel", "warning", "-i", filename, "-f", "wav", "-ar", "48000", "-"]
+            logger.trace("FFmpeg command: %s", ffmpeg_cmd)
+            ffmpeg_process = subprocess.Popen(ffmpeg_cmd, stdout=subprocess.PIPE)
         except FileNotFoundError:
             logger.error("Error opening input file %s", filename)
             raise RuntimeError(f"Error opening input file {filename}")
              
         logger.debug("Starting opusenc process")
         try:
+            opusenc_cmd = [opus_binary, "--quiet", vbr_parameter, "--bitrate", f"{bitrate:d}", "-", temp_path]
+            logger.trace("Opusenc command: %s", opusenc_cmd)
             opusenc_process = subprocess.Popen(
-                [opus_binary, "--quiet", vbr_parameter, "--bitrate", f"{bitrate:d}", "-", temp_path],
-                stdin=ffmpeg_process.stdout, stderr=subprocess.DEVNULL)
+                opusenc_cmd, stdin=ffmpeg_process.stdout, stderr=subprocess.DEVNULL)
         except Exception as e:
             logger.error("Opus encoding failed: %s", str(e))
             raise RuntimeError(f"Opus encoding failed: {str(e)}")
@@ -79,6 +83,8 @@ def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitra
         opusenc_return = opusenc_process.wait()
         ffmpeg_return = ffmpeg_process.wait()
         
+        logger.debug("Process return codes - FFmpeg: %d, Opus: %d", ffmpeg_return, opusenc_return)
+        
         if ffmpeg_return != 0:
             logger.error("FFmpeg processing failed with return code %d", ffmpeg_return)
             raise RuntimeError(f"FFmpeg processing failed with return code {ffmpeg_return}")
@@ -87,9 +93,10 @@ def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitra
             logger.error("Opus encoding failed with return code %d", opusenc_return)
             raise RuntimeError(f"Opus encoding failed with return code {opusenc_return}")
         
-        logger.debug("Opening temporary file for reading")
+        logger.debug("Opening temporary file for reading: %s", temp_path)
         try:
             tmp_file = open(temp_path, "rb")
+            logger.trace("Exiting get_opus_tempfile() with persistent temporary file")
             return tmp_file, temp_path
         except Exception as e:
             logger.error("Failed to open temporary file: %s", str(e))
@@ -99,18 +106,19 @@ def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitra
         
         logger.debug("Starting FFmpeg process")
         try:
-            ffmpeg_process = subprocess.Popen(
-                [ffmpeg_binary, "-hide_banner", "-loglevel", "warning", "-i", filename, "-f", "wav",
-                 "-ar", "48000", "-"], stdout=subprocess.PIPE)
+            ffmpeg_cmd = [ffmpeg_binary, "-hide_banner", "-loglevel", "warning", "-i", filename, "-f", "wav", "-ar", "48000", "-"]
+            logger.trace("FFmpeg command: %s", ffmpeg_cmd)
+            ffmpeg_process = subprocess.Popen(ffmpeg_cmd, stdout=subprocess.PIPE)
         except FileNotFoundError:
             logger.error("Error opening input file %s", filename)
             raise RuntimeError(f"Error opening input file {filename}")
              
         logger.debug("Starting opusenc process")
         try:
+            opusenc_cmd = [opus_binary, "--quiet", vbr_parameter, "--bitrate", f"{bitrate:d}", "-", "-"]
+            logger.trace("Opusenc command: %s", opusenc_cmd)
             opusenc_process = subprocess.Popen(
-                [opus_binary, "--quiet", vbr_parameter, "--bitrate", f"{bitrate:d}", "-", "-"],
-                stdin=ffmpeg_process.stdout, stdout=subprocess.PIPE, stderr=subprocess.DEVNULL)
+                opusenc_cmd, stdin=ffmpeg_process.stdout, stdout=subprocess.PIPE, stderr=subprocess.DEVNULL)
         except Exception as e:
             logger.error("Opus encoding failed: %s", str(e))
             raise RuntimeError(f"Opus encoding failed: {str(e)}")
@@ -124,10 +132,14 @@ def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitra
         for chunk in iter(lambda: opusenc_process.stdout.read(4096), b""):
             tmp_file.write(chunk)
             bytes_written += len(chunk)
+            if bytes_written % (1024 * 1024) == 0:  # Log every 1MB
+                logger.trace("Written %d bytes so far", bytes_written)
         
         opusenc_return = opusenc_process.wait()
         ffmpeg_return = ffmpeg_process.wait()
         
+        logger.debug("Process return codes - FFmpeg: %d, Opus: %d", ffmpeg_return, opusenc_return)
+        
         if ffmpeg_return != 0:
             logger.error("FFmpeg processing failed with return code %d", ffmpeg_return)
             raise RuntimeError(f"FFmpeg processing failed with return code {ffmpeg_return}")
@@ -139,6 +151,7 @@ def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitra
         logger.debug("Wrote %d bytes to temporary file", bytes_written)
         tmp_file.seek(0)
         
+        logger.trace("Exiting get_opus_tempfile() with in-memory temporary file")
         return tmp_file, None
 
 
@@ -152,6 +165,7 @@ def filter_directories(glob_list):
     Returns:
         list: Filtered list containing only supported audio files
     """
+    logger.trace("Entering filter_directories() with %d items", len(glob_list))
     logger.debug("Filtering %d glob results for supported audio files", len(glob_list))
     
     # Common audio file extensions supported by ffmpeg
@@ -171,6 +185,7 @@ def filter_directories(glob_list):
                 logger.trace("Skipping unsupported file: %s", name)
     
     logger.debug("Found %d supported audio files after filtering", len(filtered))
+    logger.trace("Exiting filter_directories() with %d files", len(filtered))
     return filtered
 
 
@@ -186,6 +201,7 @@ def get_input_files(input_filename):
     Returns:
         list: List of input file paths
     """
+    logger.trace("Entering get_input_files(input_filename=%s)", input_filename)
     logger.debug("Getting input files for pattern: %s", input_filename)
     
     if input_filename.endswith(".lst"):
@@ -196,6 +212,7 @@ def get_input_files(input_filename):
             for line_num, line in enumerate(file_list, 1):
                 fname = line.strip()
                 if not fname or fname.startswith('#'):  # Skip empty lines and comments
+                    logger.trace("Skipping empty line or comment at line %d", line_num)
                     continue
                 
                 # Remove any quote characters from path
@@ -204,10 +221,10 @@ def get_input_files(input_filename):
                 # Check if the path is absolute or has a drive letter (Windows)
                 if os.path.isabs(fname) or (len(fname) > 1 and fname[1] == ':'):
                     full_path = fname  # Use as is if it's an absolute path
-                    logger.trace("Using absolute path from list: %s", full_path)
+                    logger.trace("Using absolute path from line %d: %s", line_num, full_path)
                 else:
                     full_path = os.path.join(list_dir, fname)
-                    logger.trace("Using relative path from list: %s", full_path)
+                    logger.trace("Using relative path from line %d: %s -> %s", line_num, fname, full_path)
                 
                 # Handle directory paths by finding all audio files in the directory
                 if os.path.isdir(full_path):
@@ -216,11 +233,12 @@ def get_input_files(input_filename):
                     dir_files = sorted(filter_directories(glob.glob(dir_glob)))
                     if dir_files:
                         input_files.extend(dir_files)
-                        logger.debug("Found %d audio files in directory", len(dir_files))
+                        logger.debug("Found %d audio files in directory from line %d", len(dir_files), line_num)
                     else:
                         logger.warning("No audio files found in directory at line %d: %s", line_num, full_path)
                 elif os.path.isfile(full_path):
                     input_files.append(full_path)
+                    logger.trace("Added file from line %d: %s", line_num, full_path)
                 else:
                     logger.warning("File not found at line %d: %s", line_num, full_path)
         
@@ -230,6 +248,7 @@ def get_input_files(input_filename):
         input_files = sorted(filter_directories(glob.glob(input_filename)))
         logger.debug("Found %d files matching pattern", len(input_files))
     
+    logger.trace("Exiting get_input_files() with %d files", len(input_files))
     return input_files
 
 
@@ -244,13 +263,16 @@ def append_to_filename(output_filename, tag):
     Returns:
         str: Modified filename with tag
     """
+    logger.trace("Entering append_to_filename(output_filename=%s, tag=%s)", output_filename, tag)
     logger.debug("Appending tag '%s' to filename: %s", tag, output_filename)
     pos = output_filename.rfind('.')
     if pos == -1:
         result = f"{output_filename}_{tag}"
         logger.debug("No extension found, result: %s", result)
+        logger.trace("Exiting append_to_filename() with result=%s", result)
         return result
     else:
         result = f"{output_filename[:pos]}_{tag}{output_filename[pos:]}"
         logger.debug("Extension found, result: %s", result)
+        logger.trace("Exiting append_to_filename() with result=%s", result)
         return result

TonieToolbox/constants.py

@@ -9,7 +9,82 @@ TOO_MANY_SEGMENTS = -4
 TIMESTAMP_DEDUCT = 0x50000000
 OPUS_TAGS = [
     bytearray(
-        b"\x4F\x70\x75\x73\x54\x61\x67\x73\x0D\x00\x00\x00\x4C\x61\x76\x66\x35\x38\x2E\x32\x30\x2E\x31\x30\x30\x03\x00\x00\x00\x26\x00\x00\x00\x65\x6E\x63\x6F\x64\x65\x72\x3D\x6F\x70\x75\x73\x65\x6E\x63\x20\x66\x72\x6F\x6D\x20\x6F\x70\x75\x73\x2D\x74\x6F\x6F\x6C\x73\x20\x30\x2E\x31\x2E\x31\x30\x2A\x00\x00\x00\x65\x6E\x63\x6F\x64\x65\x72\x5F\x6F\x70\x74\x69\x6F\x6E\x73\x3D\x2D\x2D\x71\x75\x69\x65\x74\x20\x2D\x2D\x62\x69\x74\x72\x61\x74\x65\x20\x39\x36\x20\x2D\x2D\x76\x62\x72\x3B\x01\x00\x00\x70\x61\x64\x3D\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30"),
+        b"\x4F\x70\x75\x73\x54\x61\x67\x73\x0D\x00\x00\x00\x4C\x61\x76\x66\x35\x38\x2E\x32\x30\x2E\x31\x30\x30\x03\x00\x00\x00\x26\x00\x00\x00\x65\x6E\x63\x6F\x64\x65\x72\x3D\x6F\x70\x75\x73\x65\x6E\x63\x20\x66\x72\x6F\x6D\x20\x6F\x70\x75\x73\x2D\x74\x6F\x6F\x6C\x73\x20\x30\x2E\x31\x2E\x31\x30\x2A\x00\x00\x00\x65\x6E\x63\x6F\x64\x65\x72\x5F\x6F\x70\x74\x69\x6F\x6E\x73\x3D\x2D\x2D\x71\x75\x69\x65\x74\x20\x2D\x2D\x62\x69\x74\x72\x61\x74\x65\x20\x39\x36\x20\x2D\x2D\x76\x62\x72\x3B\x01\x00\x00\x70\x61\x64\x3D\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30"),
     bytearray(
         b"\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30\x30")
-]
+]
+
+# Mapping of language tags to ISO codes
+LANGUAGE_MAPPING = {
+    # Common language names to ISO codes
+    'deutsch': 'de-de',
+    'german': 'de-de',
+    'english': 'en-us',
+    'englisch': 'en-us',
+    'français': 'fr-fr',
+    'french': 'fr-fr',
+    'franzosisch': 'fr-fr',
+    'italiano': 'it-it',
+    'italian': 'it-it',
+    'italienisch': 'it-it',
+    'español': 'es-es',
+    'spanish': 'es-es',
+    'spanisch': 'es-es',
+    # Two-letter codes
+    'de': 'de-de',
+    'en': 'en-us',
+    'fr': 'fr-fr',
+    'it': 'it-it',
+    'es': 'es-es',
+}
+
+# Mapping of genre tags to tonie categories
+GENRE_MAPPING = {
+    # Standard Tonie category names from tonies.json
+    'hörspiel': 'Hörspiele & Hörbücher',
+    'hörbuch': 'Hörspiele & Hörbücher',
+    'hörbücher': 'Hörspiele & Hörbücher',
+    'hörspiele': 'Hörspiele & Hörbücher',
+    'audiobook': 'Hörspiele & Hörbücher',
+    'audio book': 'Hörspiele & Hörbücher',
+    'audio play': 'Hörspiele & Hörbücher',
+    'audio-play': 'Hörspiele & Hörbücher',
+    'audiospiel': 'Hörspiele & Hörbücher',
+    'geschichte': 'Hörspiele & Hörbücher',
+    'geschichten': 'Hörspiele & Hörbücher',
+    'erzählung': 'Hörspiele & Hörbücher',
+    
+    # Music related genres
+    'musik': 'music',
+    'lieder': 'music',
+    'songs': 'music',
+    'music': 'music',
+    'lied': 'music',
+    'song': 'music',
+    
+    # More specific categories
+    'kinder': 'Hörspiele & Hörbücher',
+    'children': 'Hörspiele & Hörbücher',
+    'märchen': 'Hörspiele & Hörbücher',
+    'fairy tale': 'Hörspiele & Hörbücher',
+    'märche': 'Hörspiele & Hörbücher',
+    
+    'wissen': 'Wissen & Hörmagazine',
+    'knowledge': 'Wissen & Hörmagazine',
+    'sachbuch': 'Wissen & Hörmagazine',
+    'learning': 'Wissen & Hörmagazine',
+    'educational': 'Wissen & Hörmagazine',
+    'bildung': 'Wissen & Hörmagazine',
+    'information': 'Wissen & Hörmagazine',
+    
+    'schlaf': 'Schlaflieder & Entspannung',
+    'sleep': 'Schlaflieder & Entspannung',
+    'meditation': 'Schlaflieder & Entspannung',
+    'entspannung': 'Schlaflieder & Entspannung',
+    'relaxation': 'Schlaflieder & Entspannung',
+    'schlaflied': 'Schlaflieder & Entspannung',
+    'einschlafhilfe': 'Schlaflieder & Entspannung',
+    
+    # Default to standard format for custom
+    'custom': 'Hörspiele & Hörbücher',
+}

TonieToolbox/logger.py

@@ -5,6 +5,8 @@ Logging configuration for the TonieToolbox package.
 import logging
 import os
 import sys
+from datetime import datetime
+from pathlib import Path
 
 # Define log levels and their names
 TRACE = 5  # Custom level for ultra-verbose debugging
@@ -19,20 +21,39 @@ def trace(self, message, *args, **kwargs):
 # Add trace method to the Logger class
 logging.Logger.trace = trace
 
-def setup_logging(level=logging.INFO):
+def get_log_file_path():
+    """
+    Get the path to the log file in the .tonietoolbox folder with timestamp.
+    
+    Returns:
+        Path: Path to the log file
+    """
+    # Create .tonietoolbox folder in user's home directory if it doesn't exist
+    log_dir = Path.home() / '.tonietoolbox'
+    log_dir.mkdir(exist_ok=True)
+    
+    # Create timestamp string for the filename
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    
+    # Define log file path with timestamp
+    log_file = log_dir / f'tonietoolbox_{timestamp}.log'
+    
+    return log_file
+
+def setup_logging(level=logging.INFO, log_to_file=False):
     """
     Set up logging configuration for the entire application.
     
     Args:
         level: Logging level (default: logging.INFO)
+        log_to_file: Whether to log to a file (default: False)
         
     Returns:
         logging.Logger: Root logger instance
     """
-    # Configure root logger
-    logging.basicConfig(
-        level=level,
-        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+    # Create formatter
+    formatter = logging.Formatter(
+        '%(asctime)s - %(name)s - %(levelname)s - %(message)s',
         datefmt='%Y-%m-%d %H:%M:%S'
     )
     
@@ -40,6 +61,31 @@ def setup_logging(level=logging.INFO):
     root_logger = logging.getLogger('TonieToolbox')
     root_logger.setLevel(level)
     
+    # Remove any existing handlers to avoid duplicate logs
+    for handler in root_logger.handlers[:]:
+        root_logger.removeHandler(handler)
+    
+    # Console handler
+    console_handler = logging.StreamHandler(sys.stdout)
+    console_handler.setFormatter(formatter)
+    console_handler.setLevel(level)
+    root_logger.addHandler(console_handler)
+    
+    # File handler (if enabled)
+    if log_to_file:
+        try:
+            log_file = get_log_file_path()
+            file_handler = logging.FileHandler(
+                log_file,
+                encoding='utf-8'
+            )
+            file_handler.setFormatter(formatter)
+            file_handler.setLevel(level)
+            root_logger.addHandler(file_handler)
+            root_logger.info(f"Log file created at: {log_file}")
+        except Exception as e:
+            root_logger.error(f"Failed to set up file logging: {e}")
+    
     return root_logger
 
 def get_logger(name):

TonieToolbox/media_tags.py

@@ -209,12 +209,28 @@ def get_file_tags(file_path: str) -> Dict[str, Any]:
         # Process different file types
         if isinstance(audio, ID3) or hasattr(audio, 'ID3'):
             # MP3 files
-            id3 = audio if isinstance(audio, ID3) else audio.ID3
-            for tag_key, tag_value in id3.items():
-                tag_name = tag_key.split(':')[0]  # Handle ID3 tags with colons
-                if tag_name in TAG_MAPPING:
-                    tag_value_str = str(tag_value)
-                    tags[TAG_MAPPING[tag_name]] = normalize_tag_value(tag_value_str)
+            try:
+                id3 = audio if isinstance(audio, ID3) else audio.ID3
+                for tag_key, tag_value in id3.items():
+                    tag_name = tag_key.split(':')[0]  # Handle ID3 tags with colons
+                    if tag_name in TAG_MAPPING:
+                        tag_value_str = str(tag_value)
+                        tags[TAG_MAPPING[tag_name]] = normalize_tag_value(tag_value_str)
+            except (AttributeError, TypeError) as e:
+                logger.debug("Error accessing ID3 tags: %s", e)
+                # Try alternative approach for ID3 tags
+                try:
+                    if hasattr(audio, 'tags') and audio.tags:
+                        for tag_key in audio.tags.keys():
+                            if tag_key in TAG_MAPPING:
+                                tag_value = audio.tags[tag_key]
+                                if hasattr(tag_value, 'text'):
+                                    tag_value_str = str(tag_value.text[0]) if tag_value.text else ''
+                                else:
+                                    tag_value_str = str(tag_value)
+                                tags[TAG_MAPPING[tag_key]] = normalize_tag_value(tag_value_str)
+                except Exception as e:
+                    logger.debug("Alternative ID3 tag reading failed: %s", e)
         elif isinstance(audio, (FLAC, OggOpus, OggVorbis)):
             # FLAC and OGG files
             for tag_key, tag_values in audio.items():

TonieToolbox/teddycloud.py

@@ -1,7 +1,7 @@
 #!/usr/bin/python3
 """
 TeddyCloud API client for TonieToolbox.
-Handles uploading .taf files to a TeddyCloud instance.
+Handles uploading .taf files to a TeddyCloud instance and interacting with the TeddyCloud API.
 """
 
 import os
@@ -453,6 +453,67 @@ class TeddyCloudClient:
             logger.error("Error preparing file for upload: %s", e)
             return False
 
+    def get_tonies_custom_json(self) -> Optional[list]:
+        """
+        Get tonies.custom.json from the TeddyCloud server.
+        
+        Returns:
+            List of custom tonie entries or None if request failed
+        """
+        try:
+            url = f"{self.base_url}/api/toniesCustomJson"
+            logger.info("Loading tonies.custom.json from %s", url)
+            
+            req = urllib.request.Request(url)
+            
+            with self._urlopen(req) as response:
+                data = json.loads(response.read().decode('utf-8'))
+                if isinstance(data, list):
+                    logger.info("Successfully loaded tonies.custom.json with %d entries", len(data))
+                    return data
+                else:
+                    logger.error("Invalid tonies.custom.json format, expected list")
+                    return None
+                
+        except urllib.error.HTTPError as e:
+            if e.code == 404:
+                logger.info("tonies.custom.json not found on server, starting with empty list")
+                return []
+            else:
+                logger.error("HTTP error loading tonies.custom.json: %s", e)
+                return None
+        except Exception as e:
+            logger.error("Error loading tonies.custom.json: %s", e)
+            return None
+    
+    def put_tonies_custom_json(self, custom_json_data: List[Dict[str, Any]]) -> bool:
+        """
+        Save tonies.custom.json to the TeddyCloud server.
+        
+        Args:
+            custom_json_data: List of custom tonie entries to save
+            
+        Returns:
+            True if successful, False otherwise
+        """
+        try:
+            url = f"{self.base_url}/api/toniesCustomJson"
+            logger.info("Saving tonies.custom.json to %s", url)
+            
+            data = json.dumps(custom_json_data, indent=2).encode('utf-8')
+            headers = {'Content-Type': 'application/json'}
+            
+            req = urllib.request.Request(url, data=data, headers=headers, method='PUT')
+            
+            with self._urlopen(req) as response:
+                result = response.read().decode('utf-8')
+                logger.info("Successfully saved tonies.custom.json to server")
+                return True
+                
+        except Exception as e:
+            logger.error("Error saving tonies.custom.json to server: %s", e)
+            return False
+
 def upload_to_teddycloud(file_path: str, teddycloud_url: str, ignore_ssl_verify: bool = False, 
                   special_folder: str = None, path: str = None, show_progress: bool = True,
                   connection_timeout: int = DEFAULT_CONNECTION_TIMEOUT, 
@@ -577,4 +638,42 @@ def get_tags_from_teddycloud(teddycloud_url: str, ignore_ssl_verify: bool = Fals
         
         print("-" * 60)
     
-    return True
+    return True
+
+def get_tonies_custom_json_from_server(teddycloud_url: str, ignore_ssl_verify: bool = False) -> Optional[list]:
+    """
+    Get tonies.custom.json from the TeddyCloud server.
+    
+    Args:
+        teddycloud_url: URL of the TeddyCloud instance
+        ignore_ssl_verify: If True, SSL certificate verification will be disabled
+        
+    Returns:
+        List of custom tonie entries or None if request failed
+    """
+    if not teddycloud_url:
+        logger.error("Cannot load from server: No TeddyCloud URL provided")
+        return None
+        
+    client = TeddyCloudClient(teddycloud_url, ignore_ssl_verify)
+    return client.get_tonies_custom_json()
+
+def put_tonies_custom_json_to_server(teddycloud_url: str, custom_json_data: List[Dict[str, Any]], 
+                                  ignore_ssl_verify: bool = False) -> bool:
+    """
+    Save tonies.custom.json to the TeddyCloud server.
+    
+    Args:
+        teddycloud_url: URL of the TeddyCloud instance
+        custom_json_data: List of custom tonie entries to save
+        ignore_ssl_verify: If True, SSL certificate verification will be disabled
+        
+    Returns:
+        True if successful, False otherwise
+    """
+    if not teddycloud_url:
+        logger.error("Cannot save to server: No TeddyCloud URL provided")
+        return False
+        
+    client = TeddyCloudClient(teddycloud_url, ignore_ssl_verify)
+    return client.put_tonies_custom_json(custom_json_data)