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

TonieToolbox/__init__.py

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

TonieToolbox/__main__.py

@@ -17,13 +17,41 @@ from .logger import setup_logging, get_logger
 from .filename_generator import guess_output_filename
 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
 
 def main():
     """Entry point for the TonieToolbox application."""
     parser = argparse.ArgumentParser(description='Create Tonie compatible file from Ogg opus file(s).')
     parser.add_argument('-v', '--version', action='version', version=f'TonieToolbox {__version__}',
                         help='show program version and exit')
-    parser.add_argument('input_filename', metavar='SOURCE', type=str, 
+    
+    # TeddyCloud options first to check for existence before requiring SOURCE
+    teddycloud_group = parser.add_argument_group('TeddyCloud Options')
+    teddycloud_group.add_argument('--upload', metavar='URL', action='store',
+                       help='Upload to TeddyCloud instance (e.g., https://teddycloud.example.com). Supports .taf, .jpg, .jpeg, .png files.')
+    teddycloud_group.add_argument('--include-artwork', action='store_true',
+                       help='Upload cover artwork image alongside the Tonie file when using --upload')
+    teddycloud_group.add_argument('--get-tags', action='store', metavar='URL',
+                       help='Get available tags from TeddyCloud instance')
+    teddycloud_group.add_argument('--ignore-ssl-verify', action='store_true',
+                       help='Ignore SSL certificate verification (for self-signed certificates)')
+    teddycloud_group.add_argument('--special-folder', action='store', metavar='FOLDER',
+                       help='Special folder to upload to (currently only "library" is supported)', default='library')
+    teddycloud_group.add_argument('--path', action='store', metavar='PATH',
+                       help='Path where to write the file on TeddyCloud server')
+    teddycloud_group.add_argument('--show-progress', action='store_true', default=True,
+                       help='Show progress bar during file upload (default: enabled)')
+    teddycloud_group.add_argument('--connection-timeout', type=int, metavar='SECONDS', default=10,
+                       help='Connection timeout in seconds (default: 10)')
+    teddycloud_group.add_argument('--read-timeout', type=int, metavar='SECONDS', default=300,
+                       help='Read timeout in seconds (default: 300)')
+    teddycloud_group.add_argument('--max-retries', type=int, metavar='RETRIES', default=3,
+                       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)')
+    
+    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,
                         help='the output file name (default: ---ID---)')
@@ -52,6 +80,15 @@ def main():
     parser.add_argument('-D', '--detailed-compare', action='store_true',
                        help='Show detailed OGG page differences when comparing files')
     
+    # Media tag options
+    media_tag_group = parser.add_argument_group('Media Tag Options')
+    media_tag_group.add_argument('-m', '--use-media-tags', action='store_true',
+                       help='Use media tags from audio files for naming')
+    media_tag_group.add_argument('--name-template', metavar='TEMPLATE', action='store',
+                       help='Template for naming files using media tags. Example: "{album} - {artist}"')
+    media_tag_group.add_argument('--show-tags', action='store_true',
+                       help='Show available media tags from input files')
+    
     # Version check options
     version_group = parser.add_argument_group('Version Check Options')
     version_group.add_argument('-S', '--skip-update-check', action='store_true',
@@ -69,6 +106,11 @@ def main():
     log_level_group.add_argument('-Q', '--silent', action='store_true', help='Show only errors')
 
     args = parser.parse_args()
+    
+    # Validate that input_filename is provided if not using --get-tags or --upload-existing
+    if args.input_filename is None and not (args.get_tags or args.upload):
+        parser.error("the following arguments are required: SOURCE")
+        
     if args.trace:
         from .logger import TRACE
         log_level = TRACE
@@ -80,19 +122,18 @@ def main():
         log_level = logging.ERROR
     else:
         log_level = logging.INFO
-
+    
     setup_logging(log_level)
     logger = get_logger('main')
     logger.debug("Starting TonieToolbox v%s with log level: %s", __version__, logging.getLevelName(log_level))
     
-    # Handle version cache operations
+
     if args.clear_version_cache:
         if clear_version_cache():
             logger.info("Version cache cleared successfully")
         else:
             logger.info("No version cache to clear or error clearing cache")
     
-    # Check for updates
     if not args.skip_update_check:
         logger.debug("Checking for updates (force_refresh=%s)", args.force_refresh_cache)
         is_latest, latest_version, message, update_confirmed = check_for_updates(
@@ -103,6 +144,59 @@ def main():
         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:
+        teddycloud_url = args.get_tags
+        success = get_tags_from_teddycloud(teddycloud_url, args.ignore_ssl_verify)
+        sys.exit(0 if success else 1)
+    
+    # Handle upload to TeddyCloud if requested
+    if args.upload:
+        teddycloud_url = args.upload
+        
+        if not args.input_filename:
+            logger.error("Missing input file for --upload. Provide a file path as SOURCE argument.")
+            sys.exit(1)
+            
+        # Check if the input file is already a .taf file or an image file
+        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
+            # Use get_file_paths to handle Windows backslashes and resolve the paths correctly
+            file_paths = get_file_paths(args.input_filename)
+            
+            if not file_paths:
+                logger.error("No files found for pattern %s", args.input_filename)
+                sys.exit(1)
+                
+            logger.info("Found %d file(s) to upload to TeddyCloud %s", len(file_paths), teddycloud_url)
+            
+            for file_path in file_paths:
+                # Only upload supported file types
+                if not file_path.lower().endswith(('.taf', '.jpg', '.jpeg', '.png')):
+                    logger.warning("Skipping unsupported file type: %s", file_path)
+                    continue
+                    
+                logger.info("Uploading %s to TeddyCloud %s", file_path, teddycloud_url)
+                upload_success = upload_to_teddycloud(
+                    file_path, teddycloud_url, args.ignore_ssl_verify,
+                    args.special_folder, args.path, args.show_progress,
+                    args.connection_timeout, args.read_timeout,
+                    args.max_retries, args.retry_delay
+                )
+                
+                if not upload_success:
+                    logger.error("Failed to upload %s to TeddyCloud", file_path)
+                    sys.exit(1)
+                else:
+                    logger.info("Successfully uploaded %s to TeddyCloud", file_path)
+            
+            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
+        pass
+
     ffmpeg_binary = args.ffmpeg
     if ffmpeg_binary is None:
         ffmpeg_binary = get_ffmpeg_binary(args.auto_download)
@@ -119,10 +213,24 @@ def main():
             sys.exit(1)
         logger.debug("Using opusenc binary: %s", opus_binary)
 
+    # Check for media tags library and handle --show-tags option
+    if (args.use_media_tags or args.show_tags or args.name_template) and not is_media_tags_available():
+        if not ensure_mutagen(auto_install=args.auto_download):
+            logger.warning("Media tags functionality requires the mutagen library but it could not be installed.")
+            if args.use_media_tags or args.show_tags:
+                logger.error("Cannot proceed with --use-media-tags or --show-tags without mutagen library")
+                sys.exit(1)
+        else:
+            logger.info("Successfully enabled media tag support")
+
     # Handle recursive processing
     if args.recursive:
         logger.info("Processing folders recursively: %s", args.input_filename)
-        process_tasks = process_recursive_folders(args.input_filename)
+        process_tasks = process_recursive_folders(
+            args.input_filename,
+            use_media_tags=args.use_media_tags,
+            name_template=args.name_template
+        )
         
         if not process_tasks:
             logger.error("No folders with audio files found for recursive processing")
@@ -134,6 +242,7 @@ def main():
             os.makedirs(output_dir, exist_ok=True)
             logger.debug("Created output directory: %s", output_dir)
         
+        created_files = []
         for task_index, (output_name, folder_path, audio_files) in enumerate(process_tasks):
             if args.output_to_source:
                 task_out_filename = os.path.join(folder_path, f"{output_name}.taf")
@@ -147,8 +256,102 @@ def main():
                            args.bitrate, not args.cbr, ffmpeg_binary, opus_binary, args.keep_temp, 
                            args.auto_download, not args.use_legacy_tags)
             logger.info("Successfully created Tonie file: %s", task_out_filename)
+            created_files.append(task_out_filename)
             
         logger.info("Recursive processing completed. Created %d Tonie files.", len(process_tasks))
+        
+        # Handle upload to TeddyCloud if requested
+        if args.upload and created_files:
+            teddycloud_url = args.upload
+            
+            for taf_file in created_files:
+                upload_success = upload_to_teddycloud(
+                    taf_file, teddycloud_url, args.ignore_ssl_verify,
+                    args.special_folder, args.path, args.show_progress,
+                    args.connection_timeout, args.read_timeout,
+                    args.max_retries, args.retry_delay
+                )
+                
+                if not upload_success:
+                    logger.error("Failed to upload %s to TeddyCloud", taf_file)
+                else:
+                    logger.info("Successfully uploaded %s to TeddyCloud", taf_file)
+                    
+                    # Handle artwork upload if requested
+                    if args.include_artwork:
+                        # Extract folder path from the current task
+                        folder_path = os.path.dirname(taf_file)
+                        taf_file_basename = os.path.basename(taf_file)
+                        taf_name = os.path.splitext(taf_file_basename)[0]  # Get name without extension
+                        logger.info("Looking for artwork for %s", folder_path)
+                        
+                        # Try to find cover image in the folder
+                        from .media_tags import find_cover_image
+                        artwork_path = find_cover_image(folder_path)
+                        temp_artwork = None
+                        
+                        # If no cover image found, try to extract it from one of the audio files
+                        if not artwork_path:
+                            # Get current task's audio files
+                            for task_name, task_folder, task_files in process_tasks:
+                                if task_folder == folder_path or os.path.normpath(task_folder) == os.path.normpath(folder_path):
+                                    if task_files and len(task_files) > 0:
+                                        # Try to extract from first file
+                                        from .media_tags import extract_artwork, ensure_mutagen
+                                        if ensure_mutagen(auto_install=args.auto_download):
+                                            temp_artwork = extract_artwork(task_files[0])
+                                            if temp_artwork:
+                                                artwork_path = temp_artwork
+                                                break
+                        
+                        if artwork_path:
+                            logger.info("Found artwork for %s: %s", folder_path, artwork_path)                    
+                            artwork_upload_path = "/custom_img"                            
+                            artwork_ext = os.path.splitext(artwork_path)[1]
+                            
+                            # Create a temporary copy with the same name as the taf file
+                            import shutil
+                            renamed_artwork_path = None
+                            try:
+                                renamed_artwork_path = os.path.join(os.path.dirname(artwork_path), 
+                                                                  f"{taf_name}{artwork_ext}")
+                                
+                                if renamed_artwork_path != artwork_path:
+                                    shutil.copy2(artwork_path, renamed_artwork_path)
+                                    logger.debug("Created renamed artwork copy: %s", renamed_artwork_path)
+                                
+                                logger.info("Uploading artwork to path: %s as %s%s", 
+                                          artwork_upload_path, taf_name, artwork_ext)
+                                
+                                artwork_upload_success = upload_to_teddycloud(
+                                    renamed_artwork_path, teddycloud_url, args.ignore_ssl_verify,
+                                    args.special_folder, artwork_upload_path, args.show_progress,
+                                    args.connection_timeout, args.read_timeout,
+                                    args.max_retries, args.retry_delay
+                                )
+                                
+                                if artwork_upload_success:
+                                    logger.info("Successfully uploaded artwork for %s", folder_path)
+                                else:
+                                    logger.warning("Failed to upload artwork for %s", folder_path)
+                                    
+                                if renamed_artwork_path != artwork_path and os.path.exists(renamed_artwork_path):
+                                    try:
+                                        os.unlink(renamed_artwork_path)
+                                        logger.debug("Removed temporary renamed artwork file: %s", renamed_artwork_path)
+                                    except Exception as e:
+                                        logger.debug("Failed to remove temporary renamed artwork file: %s", e)
+                                
+                                if temp_artwork and os.path.exists(temp_artwork) and temp_artwork != renamed_artwork_path:
+                                    try:
+                                        os.unlink(temp_artwork)
+                                        logger.debug("Removed temporary artwork file: %s", temp_artwork)
+                                    except Exception as e:
+                                        logger.debug("Failed to remove temporary artwork file: %s", e)
+                            except Exception as e:
+                                logger.error("Error during artwork renaming or upload: %s", e)
+                        else:
+                            logger.warning("No artwork found for %s", folder_path)
         sys.exit(0)
 
     # Handle directory or file input
@@ -178,8 +381,103 @@ def main():
         logger.error("No files found for pattern %s", args.input_filename)
         sys.exit(1)
 
+    # Show tags for input files if requested
+    if args.show_tags:
+        from .media_tags import get_file_tags
+        logger.info("Showing media tags for input files:")
+        
+        for file_index, file_path in enumerate(files):
+            tags = get_file_tags(file_path)
+            if tags:
+                print(f"\nFile {file_index + 1}: {os.path.basename(file_path)}")
+                print("-" * 40)
+                for tag_name, tag_value in sorted(tags.items()):
+                    print(f"{tag_name}: {tag_value}")
+            else:
+                print(f"\nFile {file_index + 1}: {os.path.basename(file_path)} - No tags found")
+        sys.exit(0)
+        
+    # Use media tags for file naming if requested
+    guessed_name = None
+    if args.use_media_tags:
+        # If this is a single folder, try to get consistent album info
+        if len(files) > 1 and os.path.dirname(files[0]) == os.path.dirname(files[-1]):
+            folder_path = os.path.dirname(files[0])
+            
+            from .media_tags import extract_album_info, format_metadata_filename
+            logger.debug("Extracting album info from folder: %s", folder_path)
+            
+            album_info = extract_album_info(folder_path)
+            if album_info:
+                # Use album info for naming the output file
+                template = args.name_template or "{album} - {artist}"
+                new_name = format_metadata_filename(album_info, template)
+                
+                if new_name:
+                    logger.info("Using album metadata for output filename: %s", new_name)
+                    guessed_name = new_name
+                else:
+                    logger.debug("Could not format filename from album metadata")
+        
+        # For single files, use the file's metadata
+        elif len(files) == 1:
+            from .media_tags import get_file_tags, format_metadata_filename
+            
+            tags = get_file_tags(files[0])
+            if tags:
+                template = args.name_template or "{title} - {artist}"
+                new_name = format_metadata_filename(tags, template)
+                
+                if new_name:
+                    logger.info("Using file metadata for output filename: %s", new_name)
+                    guessed_name = new_name
+                else:
+                    logger.debug("Could not format filename from file metadata")
+        
+        # For multiple files from different folders, try to use common tags if they exist
+        elif len(files) > 1:
+            from .media_tags import get_file_tags, format_metadata_filename
+            
+            # Try to find common tags among files
+            common_tags = {}
+            for file_path in files:
+                tags = get_file_tags(file_path)
+                if tags:
+                    for key, value in tags.items():
+                        if key in ['album', 'albumartist', 'artist']:
+                            if key not in common_tags:
+                                common_tags[key] = value
+                            # Only keep values that are the same across files
+                            elif common_tags[key] != value:
+                                common_tags[key] = None
+            
+            # Remove None values
+            common_tags = {k: v for k, v in common_tags.items() if v is not None}
+            
+            if common_tags:
+                template = args.name_template or "Collection - {album}" if 'album' in common_tags else "Collection"
+                new_name = format_metadata_filename(common_tags, template)
+                
+                if new_name:
+                    logger.info("Using common metadata for output filename: %s", new_name)
+                    guessed_name = new_name
+                else:
+                    logger.debug("Could not format filename from common metadata")
+
     if args.output_filename:
         out_filename = args.output_filename
+    elif guessed_name:
+        if args.output_to_source:
+            source_dir = os.path.dirname(files[0]) if files else '.'
+            out_filename = os.path.join(source_dir, guessed_name)
+            logger.debug("Using source location for output with media tags: %s", out_filename)
+        else:
+            output_dir = './output'
+            if not os.path.exists(output_dir):
+                logger.debug("Creating default output directory: %s", output_dir)
+                os.makedirs(output_dir, exist_ok=True)
+            out_filename = os.path.join(output_dir, guessed_name)
+            logger.debug("Using default output location with media tags: %s", out_filename)
     else:
         guessed_name = guess_output_filename(args.input_filename, files)    
         if args.output_to_source:
@@ -206,13 +504,115 @@ def main():
     
     if not out_filename.lower().endswith('.taf'):
         out_filename += '.taf'
-    
+        
     logger.info("Creating Tonie file: %s with %d input file(s)", out_filename, len(files))
     create_tonie_file(out_filename, files, args.no_tonie_header, args.user_timestamp,
                      args.bitrate, not args.cbr, ffmpeg_binary, opus_binary, args.keep_temp, 
                      args.auto_download, not args.use_legacy_tags)
     logger.info("Successfully created Tonie file: %s", out_filename)
-
+    
+    # Handle upload to TeddyCloud if requested
+    if args.upload:
+        teddycloud_url = args.upload
+        
+        upload_success = upload_to_teddycloud(
+            out_filename, teddycloud_url, args.ignore_ssl_verify,
+            args.special_folder, args.path, args.show_progress,
+            args.connection_timeout, args.read_timeout,
+            args.max_retries, args.retry_delay
+        )
+        if not upload_success:
+            logger.error("Failed to upload %s to TeddyCloud", out_filename)
+            sys.exit(1)
+        else:
+            logger.info("Successfully uploaded %s to TeddyCloud", out_filename)
+            
+            # Handle artwork upload if requested
+            if args.include_artwork:
+                logger.info("Looking for artwork to upload alongside the Tonie file")
+                artwork_path = None
+                
+                # Try to find a cover image in the source directory first
+                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 no cover in source directory, try to extract it from audio file
+                if not artwork_path and len(files) > 0:
+                    from .media_tags import extract_artwork, ensure_mutagen
+                    
+                    # Make sure mutagen is available for artwork extraction
+                    if ensure_mutagen(auto_install=args.auto_download):
+                        # Try to extract artwork from the first file
+                        temp_artwork = extract_artwork(files[0])
+                        if temp_artwork:
+                            artwork_path = temp_artwork
+                            # Note: this creates a temporary file that will be deleted after upload
+                
+                # Upload the artwork if found
+                if artwork_path:
+                    logger.info("Found artwork: %s", artwork_path)
+                    
+                    # Create artwork upload path - keep same path but use "custom_img" folder
+                    artwork_upload_path = args.path
+                    if not artwork_upload_path:
+                        artwork_upload_path = "/custom_img"
+                    elif not artwork_upload_path.startswith("/custom_img"):
+                        # Make sure we're using the custom_img folder
+                        if artwork_upload_path.startswith("/"):
+                            artwork_upload_path = "/custom_img" + artwork_upload_path
+                        else:
+                            artwork_upload_path = "/custom_img/" + artwork_upload_path
+                    
+                    # Get the original artwork file extension
+                    artwork_ext = os.path.splitext(artwork_path)[1]
+                    
+                    # Create a temporary copy with the same name as the taf file
+                    import shutil
+                    renamed_artwork_path = None
+                    try:
+                        renamed_artwork_path = os.path.join(os.path.dirname(artwork_path), 
+                                                          f"{os.path.splitext(os.path.basename(out_filename))[0]}{artwork_ext}")
+                        
+                        if renamed_artwork_path != artwork_path:
+                            shutil.copy2(artwork_path, renamed_artwork_path)
+                            logger.debug("Created renamed artwork copy: %s", renamed_artwork_path)
+                        
+                        logger.info("Uploading artwork to path: %s as %s%s", 
+                                  artwork_upload_path, os.path.splitext(os.path.basename(out_filename))[0], artwork_ext)
+                        
+                        artwork_upload_success = upload_to_teddycloud(
+                            renamed_artwork_path, teddycloud_url, args.ignore_ssl_verify,
+                            args.special_folder, artwork_upload_path, args.show_progress,
+                            args.connection_timeout, args.read_timeout,
+                            args.max_retries, args.retry_delay
+                        )
+                        
+                        if artwork_upload_success:
+                            logger.info("Successfully uploaded artwork")
+                        else:
+                            logger.warning("Failed to upload artwork")
+                            
+                        # Clean up temporary renamed file
+                        if renamed_artwork_path != artwork_path and os.path.exists(renamed_artwork_path):
+                            try:
+                                os.unlink(renamed_artwork_path)
+                                logger.debug("Removed temporary renamed artwork file: %s", renamed_artwork_path)
+                            except Exception as e:
+                                logger.debug("Failed to remove temporary renamed artwork file: %s", e)
+                        
+                        # Clean up temporary extracted artwork file if needed
+                        if temp_artwork and os.path.exists(temp_artwork) and temp_artwork != renamed_artwork_path:
+                            try:
+                                os.unlink(temp_artwork)
+                                logger.debug("Removed temporary artwork file: %s", temp_artwork)
+                            except Exception as e:
+                                logger.debug("Failed to remove temporary artwork file: %s", e)
+                    except Exception as e:
+                        logger.error("Error during artwork renaming or upload: %s", e)
+                else:
+                    logger.warning("No artwork found to upload")
 
 if __name__ == "__main__":
     main()

TonieToolbox/dependency_manager.py

@@ -52,6 +52,10 @@ DEPENDENCIES = {
         'darwin': {
             'package': 'opus-tools'
         }
+    },
+    'mutagen': {
+        'package': 'mutagen',
+        'python_package': True
     }
 }
 
@@ -365,6 +369,92 @@ def install_package(package_name):
         logger.error("Failed to install %s: %s", package_name, e)
         return False
 
+def install_python_package(package_name):
+    """
+    Attempt to install a Python package using pip.
+    
+    Args:
+        package_name (str): Name of the package to install
+        
+    Returns:
+        bool: True if installation was successful, False otherwise
+    """
+    logger.info("Attempting to install Python package: %s", package_name)
+    try:
+        import subprocess
+        import sys
+        
+        # Try to install the package using pip
+        subprocess.check_call([sys.executable, "-m", "pip", "install", package_name])
+        logger.info("Successfully installed Python package: %s", package_name)
+        return True
+    except Exception as e:
+        logger.error("Failed to install Python package %s: %s", package_name, str(e))
+        return False
+
+def check_python_package(package_name):
+    """
+    Check if a Python package is installed.
+    
+    Args:
+        package_name (str): Name of the package to check
+        
+    Returns:
+        bool: True if the package is installed, False otherwise
+    """
+    logger.debug("Checking if Python package is installed: %s", package_name)
+    try:
+        __import__(package_name)
+        logger.debug("Python package %s is installed", package_name)
+        return True
+    except ImportError:
+        logger.debug("Python package %s is not installed", package_name)
+        return False
+
+def ensure_mutagen(auto_install=True):
+    """
+    Ensure that the Mutagen library is available, installing it if necessary and allowed.
+    
+    Args:
+        auto_install (bool): Whether to automatically install Mutagen if not found (defaults to True)
+        
+    Returns:
+        bool: True if Mutagen is available, False otherwise
+    """
+    logger.debug("Checking if Mutagen is available")
+    
+    try:
+        import mutagen
+        logger.debug("Mutagen is already installed")
+        return True
+    except ImportError:
+        logger.debug("Mutagen is not installed")
+        
+        if auto_install:
+            logger.info("Auto-install enabled, attempting to install Mutagen")
+            if install_python_package('mutagen'):
+                try:
+                    import mutagen
+                    logger.info("Successfully installed and imported Mutagen")
+                    return True
+                except ImportError:
+                    logger.error("Mutagen was installed but could not be imported")
+            else:
+                logger.error("Failed to install Mutagen")
+        else:
+            logger.warning("Mutagen is not installed and --auto-download is not used.")
+        
+        return False
+
+def is_mutagen_available():
+    """
+    Check if the Mutagen library is available.
+    
+    Returns:
+        bool: True if Mutagen is available, False otherwise
+    """
+    return check_python_package('mutagen')
+
 def ensure_dependency(dependency_name, auto_download=False):
     """
     Ensure that a dependency is available, downloading it if necessary.
@@ -376,7 +466,7 @@ def ensure_dependency(dependency_name, auto_download=False):
     Returns:
         str: Path to the binary if available, None otherwise
     """
-    logger.info("Ensuring dependency: %s", dependency_name)
+    logger.debug("Ensuring dependency: %s", dependency_name)
     system = get_system()
     
     if system not in ['windows', 'linux', 'darwin']:
@@ -406,7 +496,7 @@ def ensure_dependency(dependency_name, auto_download=False):
             existing_binary = find_binary_in_extracted_dir(dependency_dir, binary_path)
             if existing_binary and os.path.exists(existing_binary):
                 # Verify that the binary works
-                logger.info("Found previously downloaded %s: %s", dependency_name, existing_binary)
+                logger.debug("Found previously downloaded %s: %s", dependency_name, existing_binary)
                 try:
                     if os.access(existing_binary, os.X_OK) or system == 'windows':
                         if system in ['linux', 'darwin']:
@@ -419,14 +509,14 @@ def ensure_dependency(dependency_name, auto_download=False):
                             try:
                                 result = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, timeout=5)
                                 if result.returncode == 0:
-                                    logger.info("Using previously downloaded %s: %s", dependency_name, existing_binary)
+                                    logger.debug("Using previously downloaded %s: %s", dependency_name, existing_binary)
                                     return existing_binary
                             except:
                                 # If --version fails, try without arguments
                                 try:
                                     result = subprocess.run([existing_binary], stdout=subprocess.PIPE, stderr=subprocess.PIPE, timeout=5)
                                     if result.returncode == 0:
-                                        logger.info("Using previously downloaded %s: %s", dependency_name, existing_binary)
+                                        logger.debug("Using previously downloaded %s: %s", dependency_name, existing_binary)
                                         return existing_binary
                                 except:
                                     pass
@@ -435,7 +525,7 @@ def ensure_dependency(dependency_name, auto_download=False):
                             try:
                                 result = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, timeout=5)
                                 if result.returncode == 0:
-                                    logger.info("Using previously downloaded %s: %s", dependency_name, existing_binary)
+                                    logger.debug("Using previously downloaded %s: %s", dependency_name, existing_binary)
                                     return existing_binary
                             except:
                                 pass