Mutagen

# Main entry point with auto-detection
import mutagen
from mutagen import File

# Base classes and exceptions
from mutagen import FileType, StreamInfo, Tags, Metadata, PaddingInfo, MutagenError

# Version information
from mutagen import version, version_string

import mutagen

# Automatically detect format and load appropriate handler
audio_file = mutagen.File("song.mp3")  # Returns MP3 instance
audio_file = mutagen.File("song.flac")  # Returns FLAC instance
audio_file = mutagen.File("song.m4a")   # Returns MP4 instance

# Access metadata like a dictionary
print(audio_file["TIT2"])  # Title for MP3/ID3
print(audio_file["TITLE"]) # Title for FLAC/Vorbis

# Stream information
info = audio_file.info
print(f"Length: {info.length} seconds")
print(f"Bitrate: {info.bitrate} bps")

from mutagen.mp3 import MP3
from mutagen.flac import FLAC
from mutagen.mp4 import MP4

mp3_file = MP3("song.mp3")
flac_file = FLAC("song.flac") 
mp4_file = MP4("song.m4a")

# File detection and base classes
def File(filething, options=None, easy=False) -> FileType | None:
    """Auto-detect audio format and return appropriate FileType instance.
    
    Args:
        filething: File path string or file-like object
        options: Sequence of FileType implementations, defaults to all included ones
        easy: If True, use easy interface when available
        
    Returns:
        FileType instance for the detected format, or None if type couldn't be determined
        
    Raises:
        MutagenError: if the detected type fails to load the file
    """

class FileType:
    """Abstract base class for all audio file types.
    
    Attributes:
        tags: Tag container for the file (format-specific)
        info: StreamInfo instance with technical details
    """
    
    def save(self, **kwargs) -> None:
        """Save tags back to file"""
    
    def delete(self) -> None:
        """Remove all tags from file"""

class StreamInfo:
    """Abstract base class for audio stream information.
    
    Attributes:
        length: Duration in seconds (float)
        bitrate: Bitrate in bits per second (int)
    """

# Dictionary-like tag access
audio_file["TITLE"] = ["Song Title"]
audio_file["ARTIST"] = ["Artist Name"] 
audio_file["ALBUM"] = ["Album Name"]

# Save changes
audio_file.save()

# Remove specific tag
del audio_file["GENRE"]

# Remove all tags
audio_file.delete()

from mutagen.easyid3 import EasyID3
from mutagen.easymp4 import EasyMP4

# Normalized tag names across formats
easy_id3 = EasyID3("song.mp3")
easy_mp4 = EasyMP4("song.m4a")

# Same tag names work for both
easy_id3["title"] = ["Song Title"]
easy_mp4["title"] = ["Song Title"]

# Embedded artwork (format-dependent)
from mutagen.id3 import APIC
from mutagen.mp4 import MP4Cover

# ID3 artwork
mp3_file["APIC:"] = APIC(data=image_bytes, type=3, desc="Cover")

# MP4 artwork  
mp4_file["covr"] = [MP4Cover(image_bytes, MP4Cover.FORMAT_JPEG)]

# Custom metadata
mp4_file["----:com.apple.iTunes:CUSTOM"] = [b"Custom Value"]

from mutagen import MutagenError

try:
    audio_file = mutagen.File("corrupted.mp3")
    if audio_file is None:
        print("Unsupported or corrupted file")
except MutagenError as e:
    print(f"Mutagen error: {e}")
except IOError as e:
    print(f"File error: {e}")