TonieToolbox 0.5.1__py3-none-any.whl → 0.6.0a2__py3-none-any.whl

TonieToolbox/__init__.py

@@ -2,4 +2,4 @@
 TonieToolbox - Convert audio files to Tonie box compatible format
 """
 
-__version__ = '0.5.1'
+__version__ = '0.6.0a2'

TonieToolbox/__main__.py

@@ -21,6 +21,7 @@ from .teddycloud import TeddyCloudClient
 from .tags import get_tags
 from .tonies_json import fetch_and_update_tonies_json_v1, fetch_and_update_tonies_json_v2
 from .artwork import upload_artwork
+from .integration import handle_integration, handle_config
 
 def main():
     """Entry point for the TonieToolbox application."""
@@ -98,7 +99,14 @@ def main():
     parser.add_argument('-C', '--compare', action='store', metavar='FILE2', 
                        help='Compare input file with another .taf file for debugging')
     parser.add_argument('-D', '--detailed-compare', action='store_true',
-                       help='Show detailed OGG page differences when comparing files')    
+                       help='Show detailed OGG page differences when comparing files')  
+    # ------------- Parser - Context Menu Integration -------------
+    parser.add_argument('--config-integration', action='store_true',
+                       help='Configure context menu integration')
+    parser.add_argument('--install-integration', action='store_true',
+                       help='Integrate with the system (e.g., create context menu entries)')
+    parser.add_argument('--uninstall-integration', action='store_true',
+                       help='Uninstall context menu integration')
     # ------------- Parser - 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',
@@ -127,7 +135,7 @@ def main():
     args = parser.parse_args()
     
     # ------------- Parser - Source Input -------------
-    if args.input_filename is None and not (args.get_tags or args.upload):
+    if args.input_filename is None and not (args.get_tags or args.upload or args.install_integration or args.uninstall_integration or args.config_integration):
         parser.error("the following arguments are required: SOURCE")
 
     # ------------- Logging -------------
@@ -166,7 +174,23 @@ 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.")
-
+    # ------------- Context Menu Integration -------------
+    if args.install_integration or args.uninstall_integration:
+        logger.debug("Context menu integration requested: install=%s, uninstall=%s", 
+                  args.install_integration, args.uninstall_integration)
+        success = handle_integration(args)
+        if success:
+            if args.install_integration:
+                logger.info("Context menu integration installed successfully")
+            else:
+                logger.info("Context menu integration uninstalled successfully")
+        else:
+            logger.error("Failed to handle context menu integration")
+        sys.exit(0)
+    if args.config_integration:
+        logger.debug("Opening configuration file for editing")
+        handle_config()
+        sys.exit(0)
         # ------------- Normalize Path Input -------------
     if args.input_filename:
         logger.debug("Original input path: %s", args.input_filename)
@@ -224,89 +248,72 @@ def main():
                 print(f"\nFile {file_index + 1}: {os.path.basename(file_path)} - No tags found")
         sys.exit(0)
     # ------------- Direct Upload -------------    
-        if os.path.exists(args.input_filename) and os.path.isfile(args.input_filename):
-            file_path = args.input_filename
-            file_size = os.path.getsize(file_path)
-            file_ext = os.path.splitext(file_path)[1].lower()    
-    
-            if args.upload and not args.recursive and file_ext == '.taf':
-                logger.debug("Upload to TeddyCloud requested: %s", teddycloud_url)
-                logger.trace("TeddyCloud upload parameters: path=%s, special_folder=%s, ignore_ssl=%s", 
-                          args.path, args.special_folder, args.ignore_ssl_verify)
-
+    if os.path.exists(args.input_filename) and os.path.isfile(args.input_filename):
+        file_path = args.input_filename
+        file_size = os.path.getsize(file_path)
+        file_ext = os.path.splitext(file_path)[1].lower()    
 
-                logger.debug("File to upload: %s (size: %d bytes, type: %s)", 
-                          file_path, file_size, file_ext)
-                logger.info("Uploading %s to TeddyCloud %s", file_path, teddycloud_url)
-                logger.trace("Starting upload process for %s", file_path)
-                response = client.upload_file(
-                    destination_path=args.path, 
-                    file_path=file_path,                   
-                    special=args.special_folder,
-                )
-                logger.trace("Upload response received: %s", response)
-                upload_success = response.get('success', False)
-                if not upload_success:
-                    error_msg = response.get('message', 'Unknown error')
-                    logger.error("Failed to upload %s to TeddyCloud: %s (HTTP Status: %s, Response: %s)", 
-                                 file_path, error_msg, response.get('status_code', 'Unknown'), response)
-                    logger.trace("Exiting with code 1 due to upload failure")
-                    sys.exit(1)
-                else:
-                    logger.info("Successfully uploaded %s to TeddyCloud", file_path)
-                    logger.debug("Upload response details: %s", 
-                              {k: v for k, v in response.items() if k != 'success'})
-                artwork_url = None
-                if args.include_artwork and file_path.lower().endswith('.taf'):
-                    source_dir = os.path.dirname(file_path)
-                    logger.info("Looking for artwork to upload for %s", file_path)
-                    logger.debug("Searching for artwork in directory: %s", source_dir)
-                    logger.trace("Calling upload_artwork function")
-                    success, artwork_url = upload_artwork(client, file_path, source_dir, [])
-                    logger.trace("upload_artwork returned: success=%s, artwork_url=%s", 
-                              success, artwork_url)
-                    if success:
-                        logger.info("Successfully uploaded artwork for %s", file_path)
-                        logger.debug("Artwork URL: %s", artwork_url)
-                    else:
-                        logger.warning("Failed to upload artwork for %s", file_path)
-                        logger.debug("No suitable artwork found or upload failed")
-                if args.create_custom_json and file_path.lower().endswith('.taf'):
-                    output_dir = './output'
-                    logger.debug("Creating/ensuring output directory for JSON: %s", output_dir)
-                    if not os.path.exists(output_dir):
-                        os.makedirs(output_dir, exist_ok=True)
-                        logger.trace("Created output directory: %s", output_dir)
-                    logger.debug("Updating tonies.custom.json with: taf=%s, artwork_url=%s", 
-                              file_path, artwork_url)
-                    client_param = client
-
-                    if args.version_2:
-                        logger.debug("Using version 2 of the Tonies JSON format")
-                        success = fetch_and_update_tonies_json_v2(client_param, file_path, [], artwork_url, output_dir)
-                    else:
-                        success = fetch_and_update_tonies_json_v1(client_param, file_path, [], artwork_url, output_dir)
-                    if success:
-                        logger.info("Successfully updated Tonies JSON for %s", file_path)
-                    else:
-                        logger.warning("Failed to update Tonies JSON for %s", file_path)
-                        logger.debug("fetch_and_update_tonies_json returned failure")
-                logger.trace("Exiting after direct upload with code 0")
-                sys.exit(0)
-            elif not args.recursive:
-                if not os.path.exists(args.input_filename):
-                    logger.error("File not found: %s", args.input_filename)
-                elif not os.path.isfile(args.input_filename):
-                    logger.error("Not a regular file: %s", args.input_filename)
-                logger.debug("File exists: %s, Is file: %s", 
-                          os.path.exists(args.input_filename), 
-                          os.path.isfile(args.input_filename) if os.path.exists(args.input_filename) else False)
-                logger.trace("Exiting with code 1 due to invalid input file")
+        if args.upload and not args.recursive and file_ext == '.taf':
+            logger.debug("Upload to TeddyCloud requested: %s", teddycloud_url)
+            logger.trace("TeddyCloud upload parameters: path=%s, special_folder=%s, ignore_ssl=%s", 
+                      args.path, args.special_folder, args.ignore_ssl_verify)
+            logger.debug("File to upload: %s (size: %d bytes, type: %s)", 
+                      file_path, file_size, file_ext)
+            logger.info("Uploading %s to TeddyCloud %s", file_path, teddycloud_url)
+            logger.trace("Starting upload process for %s", file_path)
+            response = client.upload_file(
+                destination_path=args.path, 
+                file_path=file_path,                   
+                special=args.special_folder,
+            )
+            logger.trace("Upload response received: %s", response)
+            upload_success = response.get('success', False)
+            if not upload_success:
+                error_msg = response.get('message', 'Unknown error')
+                logger.error("Failed to upload %s to TeddyCloud: %s (HTTP Status: %s, Response: %s)", 
+                             file_path, error_msg, response.get('status_code', 'Unknown'), response)
+                logger.trace("Exiting with code 1 due to upload failure")
                 sys.exit(1)
-        
-        if args.recursive and args.upload:
-            logger.info("Recursive mode with upload enabled: %s -> %s", args.input_filename, teddycloud_url)
-            logger.debug("Will process all files in directory recursively and upload to TeddyCloud")
+            else:
+                logger.info("Successfully uploaded %s to TeddyCloud", file_path)
+                logger.debug("Upload response details: %s", 
+                          {k: v for k, v in response.items() if k != 'success'})
+            artwork_url = None
+            if args.include_artwork and file_path.lower().endswith('.taf'):
+                source_dir = os.path.dirname(file_path)
+                logger.info("Looking for artwork to upload for %s", file_path)
+                logger.debug("Searching for artwork in directory: %s", source_dir)
+                logger.trace("Calling upload_artwork function")
+                success, artwork_url = upload_artwork(client, file_path, source_dir, [])
+                logger.trace("upload_artwork returned: success=%s, artwork_url=%s", 
+                          success, artwork_url)
+                if success:
+                    logger.info("Successfully uploaded artwork for %s", file_path)
+                    logger.debug("Artwork URL: %s", artwork_url)
+                else:
+                    logger.warning("Failed to upload artwork for %s", file_path)
+                    logger.debug("No suitable artwork found or upload failed")
+            if args.create_custom_json and file_path.lower().endswith('.taf'):
+                output_dir = './output'
+                logger.debug("Creating/ensuring output directory for JSON: %s", output_dir)
+                if not os.path.exists(output_dir):
+                    os.makedirs(output_dir, exist_ok=True)
+                    logger.trace("Created output directory: %s", output_dir)
+                logger.debug("Updating tonies.custom.json with: taf=%s, artwork_url=%s", 
+                          file_path, artwork_url)
+                client_param = client
+                if args.version_2:
+                    logger.debug("Using version 2 of the Tonies JSON format")
+                    success = fetch_and_update_tonies_json_v2(client_param, file_path, [], artwork_url, output_dir)
+                else:
+                    success = fetch_and_update_tonies_json_v1(client_param, file_path, [], artwork_url, output_dir)
+                if success:
+                    logger.info("Successfully updated Tonies JSON for %s", file_path)
+                else:
+                    logger.warning("Failed to update Tonies JSON for %s", file_path)
+                    logger.debug("fetch_and_update_tonies_json returned failure")
+            logger.trace("Exiting after direct upload with code 0")
+            sys.exit(0)        
     
     # ------------- Librarys / Prereqs -------------
     logger.debug("Checking for external dependencies")

TonieToolbox/artwork.py

@@ -13,17 +13,22 @@ from .teddycloud import TeddyCloudClient
 from .media_tags import extract_artwork, find_cover_image
 
 
-def upload_artwork(client: TeddyCloudClient, taf_filename, source_path, audio_files) -> Tuple[bool, Optional[str]]:
+def upload_artwork(
+    client: TeddyCloudClient,
+    taf_filename: str,
+    source_path: str,
+    audio_files: list[str],
+) -> tuple[bool, Optional[str]]:
     """
     Find and upload artwork for a Tonie file.
-    
+
     Args:
-        client: TeddyCloudClient instance to use for API communication
-        taf_filename: The filename of the Tonie file (.taf)
-        source_path: Source directory to look for artwork
-        audio_files: List of audio files to extract artwork from if needed        
+        client (TeddyCloudClient): TeddyCloudClient instance to use for API communication
+        taf_filename (str): The filename of the Tonie file (.taf)
+        source_path (str): Source directory to look for artwork
+        audio_files (list[str]): List of audio files to extract artwork from if needed
     Returns:
-        tuple: (success, artwork_url) where success is a boolean and artwork_url is the URL of the uploaded artwork
+        tuple[bool, Optional[str]]: (success, artwork_url) where success is a boolean and artwork_url is the URL of the uploaded artwork
     """
     logger = get_logger('artwork')
     logger.info("Looking for artwork for Tonie file: %s", taf_filename)

TonieToolbox/audio_conversion.py

@@ -7,27 +7,36 @@ import glob
 import subprocess
 import tempfile
 from .dependency_manager import get_ffmpeg_binary, get_opus_binary
+from .constants import SUPPORTED_EXTENSIONS
 from .logger import get_logger
 
 logger = get_logger('audio_conversion')
 
 
-def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitrate=48, vbr=True, keep_temp=False, auto_download=False, no_mono_conversion=False):
+def get_opus_tempfile(
+    ffmpeg_binary: str = None,
+    opus_binary: str = None,
+    filename: str = None,
+    bitrate: int = 48,
+    vbr: bool = True,
+    keep_temp: bool = False,
+    auto_download: bool = False,
+    no_mono_conversion: bool = False
+) -> tuple[tempfile.SpooledTemporaryFile | None, str | None]:
     """
     Convert an audio file to Opus format and return a temporary file handle.
     
     Args:
-        ffmpeg_binary: Path to the ffmpeg binary. If None, will be auto-detected or downloaded.
-        opus_binary: Path to the opusenc binary. If None, will be auto-detected or downloaded.
-        filename: Path to the input audio file
-        bitrate: Bitrate for the Opus encoding in kbps
-        vbr: Whether to use variable bitrate encoding
-        keep_temp: Whether to keep the temporary files for testing
-        auto_download: Whether to automatically download dependencies if not found
-        no_mono_conversion: Whether to skip mono to stereo conversion
-        
+        ffmpeg_binary (str | None): Path to the ffmpeg binary. If None, will be auto-detected or downloaded.
+        opus_binary (str | None): Path to the opusenc binary. If None, will be auto-detected or downloaded.
+        filename (str | None): Path to the input audio file
+        bitrate (int): Bitrate for the Opus encoding in kbps
+        vbr (bool): Whether to use variable bitrate encoding
+        keep_temp (bool): Whether to keep the temporary files for testing
+        auto_download (bool): Whether to automatically download dependencies if not found
+        no_mono_conversion (bool): Whether to skip mono to stereo conversion
     Returns:
-        tuple: (file handle, temp_file_path) or (file handle, None) if keep_temp is False
+        tuple[tempfile.SpooledTemporaryFile | None, str | None]: (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, no_mono_conversion=%s)",
                 ffmpeg_binary, opus_binary, filename, bitrate, vbr, keep_temp, auto_download, no_mono_conversion)
@@ -198,24 +207,20 @@ def get_opus_tempfile(ffmpeg_binary=None, opus_binary=None, filename=None, bitra
         return tmp_file, None
 
 
-def filter_directories(glob_list):
+def filter_directories(glob_list: list[str]) -> list[str]:
     """
     Filter a list of glob results to include only audio files that can be handled by ffmpeg.
     
     Args:
-        glob_list: List of path names from glob.glob()
-        
+        glob_list (list[str]): List of path names from glob.glob()
     Returns:
-        list: Filtered list containing only supported audio files
+        list[str]: 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
-    supported_extensions = [
-        '.wav', '.mp3', '.aac', '.m4a', '.flac', '.ogg', '.opus',
-        '.ape', '.wma', '.aiff', '.mp2', '.mp4', '.webm', '.mka'
-    ]
+    supported_extensions = SUPPORTED_EXTENSIONS
+    logger.debug("Supported audio file extensions: %s", supported_extensions)
     
     filtered = []
     for name in glob_list:
@@ -232,17 +237,16 @@ def filter_directories(glob_list):
     return filtered
 
 
-def get_input_files(input_filename):
+def get_input_files(input_filename: str) -> list[str]:
     """
     Get a list of input files to process.
     
     Supports direct file paths, directory paths, glob patterns, and .lst files.
     
     Args:
-        input_filename: Input file pattern or list file path
-        
+        input_filename (str): Input file pattern or list file path
     Returns:
-        list: List of input file paths
+        list[str]: 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)
@@ -320,14 +324,13 @@ def get_input_files(input_filename):
     return input_files
 
 
-def append_to_filename(output_filename, tag):
+def append_to_filename(output_filename: str, tag: str) -> str:
     """
     Append a tag to a filename, preserving the extension.
     
     Args:
-        output_filename: Original filename
-        tag: Tag to append (typically an 8-character hex value)
-        
+        output_filename (str): Original filename
+        tag (str): Tag to append (typically an 8-character hex value)
     Returns:
         str: Modified filename with tag
     """

TonieToolbox/constants.py

@@ -1,13 +1,13 @@
 """
 Constants used throughout the TonieToolbox package
 """
-SAMPLE_RATE_KHZ = 48
-ONLY_CONVERT_FRAMEPACKING = -1
-OTHER_PACKET_NEEDED = -2
-DO_NOTHING = -3
-TOO_MANY_SEGMENTS = -4
-TIMESTAMP_DEDUCT = 0x50000000
-OPUS_TAGS = [
+SAMPLE_RATE_KHZ: int = 48
+ONLY_CONVERT_FRAMEPACKING: int = -1
+OTHER_PACKET_NEEDED: int = -2
+DO_NOTHING: int = -3
+TOO_MANY_SEGMENTS: int = -4
+TIMESTAMP_DEDUCT: int = 0x50000000
+OPUS_TAGS: list[bytearray] = [
     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"),
     bytearray(
@@ -15,7 +15,7 @@ OPUS_TAGS = [
 ]
 
 # Mapping of language tags to ISO codes
-LANGUAGE_MAPPING = {
+LANGUAGE_MAPPING: dict[str, str] = {
     # Common language names to ISO codes
     'deutsch': 'de-de',
     'german': 'de-de',
@@ -39,7 +39,7 @@ LANGUAGE_MAPPING = {
 }
 
 # Mapping of genre tags to tonie categories
-GENRE_MAPPING = {
+GENRE_MAPPING: dict[str, str] = {
     # Standard Tonie category names from tonies.json
     'hörspiel': 'Hörspiele & Hörbücher',
     'hörbuch': 'Hörspiele & Hörbücher',
@@ -87,4 +87,105 @@ GENRE_MAPPING = {
     
     # Default to standard format for custom
     'custom': 'Hörspiele & Hörbücher',
+}
+
+    # Supported file extensions for audio files
+SUPPORTED_EXTENSIONS = [
+        '.wav', '.mp3', '.aac', '.m4a', '.flac', '.ogg', '.opus',
+        '.ape', '.wma', '.aiff', '.mp2', '.mp4', '.webm', '.mka'
+    ]
+
+ARTWORK_NAMES = [
+        'cover', 'folder', 'album', 'front', 'artwork', 'image', 
+        'albumart', 'albumartwork', 'booklet'
+    ]
+ARTWORK_EXTENSIONS = ['.jpg', '.jpeg', '.png', '.bmp', '.gif']
+
+
+TAG_VALUE_REPLACEMENTS = {
+    "Die drei ???": "Die drei Fragezeichen",
+    "Die Drei ???": "Die drei Fragezeichen",
+    "DIE DREI ???": "Die drei Fragezeichen",
+    "Die drei !!!": "Die drei Ausrufezeichen",
+    "Die Drei !!!": "Die drei Ausrufezeichen",
+    "DIE DREI !!!": "Die drei Ausrufezeichen",
+    "TKKG™": "TKKG",
+    "Die drei ??? Kids": "Die drei Fragezeichen Kids",
+    "Die Drei ??? Kids": "Die drei Fragezeichen Kids",
+    "Bibi & Tina": "Bibi und Tina",
+    "Benjamin Blümchen™": "Benjamin Blümchen",
+    "???": "Fragezeichen",
+    "!!!": "Ausrufezeichen",
+}
+
+TAG_MAPPINGS = {
+    # ID3 (MP3) tags
+    'TIT2': 'title',
+    'TALB': 'album',
+    'TPE1': 'artist',
+    'TPE2': 'albumartist',
+    'TCOM': 'composer',
+    'TRCK': 'tracknumber',
+    'TPOS': 'discnumber',
+    'TDRC': 'date',
+    'TCON': 'genre',
+    'TPUB': 'publisher',
+    'TCOP': 'copyright',
+    'COMM': 'comment',
+    
+    # Vorbis tags (FLAC, OGG)
+    'title': 'title',
+    'album': 'album',
+    'artist': 'artist',
+    'albumartist': 'albumartist',
+    'composer': 'composer',
+    'tracknumber': 'tracknumber',
+    'discnumber': 'discnumber',
+    'date': 'date',
+    'genre': 'genre',
+    'publisher': 'publisher',
+    'copyright': 'copyright',
+    'comment': 'comment',
+    
+    # MP4 (M4A, AAC) tags
+    '©nam': 'title',
+    '©alb': 'album',
+    '©ART': 'artist',
+    'aART': 'albumartist',
+    '©wrt': 'composer',
+    'trkn': 'tracknumber',
+    'disk': 'discnumber',
+    '©day': 'date',
+    '©gen': 'genre',
+    '©pub': 'publisher',
+    'cprt': 'copyright',
+    '©cmt': 'comment',
+    
+    # Additional tags some files might have
+    'album_artist': 'albumartist',
+    'track': 'tracknumber',
+    'track_number': 'tracknumber',
+    'disc': 'discnumber',
+    'disc_number': 'discnumber',
+    'year': 'date',
+    'albuminterpret': 'albumartist',  # German tag name
+    'interpret': 'artist',            # German tag name
+
+}
+
+CONFIG_TEMPLATE = {
+    "metadata": {
+        "description": "TonieToolbox configuration",
+        "config_version": "1.0"     
+    },
+    "log_level": "silent", # Options: trace, debug, info, warning, error, critical, silent
+    "log_to_file": False, # True if you want to log to a file ~\.tonietoolbox\logs
+    "upload": {
+        "url": [""], # https://teddycloud.example.com        
+        "ignore_ssl_verify": False, # True if you want to ignore SSL certificate verification
+        "username": "", # Basic Auth username
+        "password": "", # Basic Auth password
+        "client_cert_path": "", # Path to client certificate file
+        "client_cert_key_path": "" # Path to client certificate key file
+    }
 }

TonieToolbox/filename_generator.py

@@ -15,10 +15,9 @@ def sanitize_filename(filename: str) -> str:
     Sanitize a filename by removing invalid characters and trimming.
     
     Args:
-        filename: The filename to sanitize
-        
+        filename (str): The filename to sanitize
     Returns:
-        A sanitized filename
+        str: A sanitized filename
     """
     # Remove invalid characters for filenames
     sanitized = re.sub(r'[<>:"/\\|?*]', '_', filename)
@@ -29,7 +28,7 @@ def sanitize_filename(filename: str) -> str:
         return "tonie"
     return sanitized
 
-def guess_output_filename(input_filename: str, input_files: List[str] = None) -> str:
+def guess_output_filename(input_filename: str, input_files: list[str] = None) -> str:
     """
     Generate a sensible output filename based on input file or directory.
     
@@ -40,11 +39,10 @@ def guess_output_filename(input_filename: str, input_files: List[str] = None) ->
     4. For multiple files: Use the common parent directory name
     
     Args:
-        input_filename: The input filename or pattern
-        input_files: List of resolved input files (optional)
-        
+        input_filename (str): The input filename or pattern
+        input_files (list[str] | None): List of resolved input files (optional)
     Returns:
-        Generated output filename without extension
+        str: Generated output filename without extension
     """
     logger.debug("Guessing output filename from input: %s", input_filename)
     

TonieToolbox/integration.py

@@ -0,0 +1,68 @@
+import platform
+from .logger import get_logger
+
+logger = get_logger(__name__)
+
+def handle_integration(args):
+    import platform
+    if platform.system() == 'Windows':
+        from .integration_windows import WindowsClassicContextMenuIntegration as ContextMenuIntegration
+        if args.install_integration:
+            success = ContextMenuIntegration.install()
+            if success:
+                logger.info("Integration installed successfully.")
+                return True
+            else:
+                logger.error("Integration installation failed.")
+                return False
+        elif args.uninstall_integration:
+            success = ContextMenuIntegration.uninstall()
+            if success:
+                logger.info("Integration uninstalled successfully.")
+                return True
+            else:
+                logger.error("Integration uninstallation failed.")
+                return False
+    elif platform.system() == 'Darwin':
+        from .integration_macos import MacOSContextMenuIntegration as ContextMenuIntegration
+        if args.install_integration:
+            success = ContextMenuIntegration.install()
+            if success:
+                logger.info("Integration installed successfully.")
+                return True
+            else:
+                logger.error("Integration installation failed.")
+                return False
+        elif args.uninstall_integration:
+            success = ContextMenuIntegration.uninstall()
+            if success:
+                logger.info("Integration uninstalled successfully.")
+                return True
+            else:
+                logger.error("Integration uninstallation failed.")
+                return False
+    elif platform.system() == 'Linux':
+        raise NotImplementedError("Context menu integration is not supported on Linux YET. But Soon™")
+    else:
+        raise NotImplementedError(f"Context menu integration is not supported on this OS: {platform.system()}")
+    
+def handle_config():
+    """Opens the configuration file in the default text editor."""
+    import os
+    import platform
+    import subprocess
+
+    config_path = os.path.join(os.path.expanduser("~"), ".tonietoolbox", "config.json")
+
+    if not os.path.exists(config_path):
+        logger.info(f"Configuration file not found at {config_path}.")
+        logger.info("Creating a new configuration file. Using --install-integration will create a new config file.")
+        return
+    if platform.system() == "Windows":
+        os.startfile(config_path)
+    elif platform.system() == "Darwin":
+        subprocess.call(["open", config_path])
+    elif platform.system() == "Linux":
+        subprocess.call(["xdg-open", config_path])
+    else:
+        logger.error(f"Unsupported OS: {platform.system()}")