{"library":"mutagen","title":"Mutagen Audio Tagging Library","description":"Mutagen is a Python library to read and write audio tags for many formats, including MP3, FLAC, Ogg Vorbis/Opus/FLAC, M4A, ASF, and more. It provides both high-level access for common tags and low-level access to manipulate specific frame types. The library is actively maintained, with minor versions released every few months, currently at 1.47.0.","language":"python","status":"active","last_verified":"Wed May 13","install":{"commands":["pip install mutagen"],"cli":null},"imports":["from mutagen import File","from mutagen.mp3 import MP3","from mutagen.easyid3 import EasyID3","from mutagen.id3 import ID3","from mutagen.id3 import ID3NoHeaderError"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nimport mutagen\nfrom mutagen.id3 import ID3, TIT2, TPE1, TALB\nfrom mutagen.mp3 import MP3\n\n# --- Create a dummy MP3 file for demonstration ---\n# In a real scenario, you would use an actual audio file.\n# This creates a minimal, valid-ish MP3 structure that mutagen can parse.\ntemp_mp3_path = \"temp_quickstart_audio.mp3\"\ntry:\n    with open(temp_mp3_path, \"wb\") as f:\n        f.write(b'\\xFF\\xFB\\x30\\x00' + b'\\x00' * 1024)\n\n    # --- Initializing and Adding Tags (using ID3 frames) ---\n    # mutagen.File() is the primary entry point; for MP3s, it returns an MP3 object.\n    audio_file = mutagen.File(temp_mp3_path)\n    if audio_file is None:\n        raise ValueError(\"Could not open dummy MP3 file.\")\n\n    # If the file has no ID3 tags, create a new ID3 object for it.\n    if audio_file.tags is None:\n        audio_file.tags = ID3()\n    \n    # Set common tags using ID3 frame objects\n    audio_file.tags.add(TIT2(encoding=3, text=[\"My New Track Title\"])) # Title\n    audio_file.tags.add(TPE1(encoding=3, text=[\"Example Artist\"])) # Artist\n    audio_file.tags.add(TALB(encoding=3, text=[\"Demo Album\"])) # Album\n    \n    audio_file.save() # Crucial: Saves changes to the file\n\n    print(f\"Tags written to '{temp_mp3_path}' using ID3 frames.\")\n\n    # --- Reading Tags (using EasyID3 for simpler access) ---\n    # Open the file again, using easy=True for a dictionary-like interface\n    easy_audio = mutagen.File(temp_mp3_path, easy=True)\n    if easy_audio is None:\n        raise ValueError(\"Could not re-open dummy MP3 with easy=True.\")\n\n    print(\"\\n--- Reading Tags (using EasyID3) ---\")\n    print(f\"Title: {easy_audio.get('title', ['N/A'])[0]}\")\n    print(f\"Artist: {easy_audio.get('artist', ['N/A'])[0]}\")\n    print(f\"Album: {easy_audio.get('album', ['N/A'])[0]}\")\n    \n    # --- Updating Tags (using EasyID3) ---\n    easy_audio[\"artist\"] = [\"Updated Artist Name\"]\n    easy_audio.save() # Save the update\n    \n    reloaded_easy_audio = mutagen.File(temp_mp3_path, easy=True)\n    print(f\"\\nEasyID3 Artist (updated): {reloaded_easy_audio.get('artist', ['N/A'])[0]}\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\n    print(\"Ensure you have write permissions in the current directory and the file can be created/accessed.\")\nfinally:\n    # Clean up the dummy file\n    if os.path.exists(temp_mp3_path):\n        os.remove(temp_mp3_path)\n        print(f\"\\nCleaned up '{temp_mp3_path}'.\")","lang":"python","description":"This quickstart demonstrates how to create a dummy MP3 file, add ID3 tags using `mutagen.id3.ID3` frame objects, save them, then read and update tags using the simpler `mutagen.File(..., easy=True)` interface. Remember to always call `.save()` to persist changes.","tag":null,"tag_description":null,"last_tested":"2026-04-24","results":[{"runtime":"python:3.10-alpine","exit_code":0},{"runtime":"python:3.10-slim","exit_code":0},{"runtime":"python:3.11-alpine","exit_code":0},{"runtime":"python:3.11-slim","exit_code":0},{"runtime":"python:3.12-alpine","exit_code":0},{"runtime":"python:3.12-slim","exit_code":0},{"runtime":"python:3.13-alpine","exit_code":0},{"runtime":"python:3.13-slim","exit_code":0},{"runtime":"python:3.9-alpine","exit_code":0},{"runtime":"python:3.9-slim","exit_code":0}]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-13","installed_version":"1.47.0","pypi_latest":"1.47.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.6,"avg_import_s":0.02,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.02,"mem_mb":0.8,"disk_size":"19.2M"},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.02,"mem_mb":0.8,"disk_size":"19.2M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.5,"import_time_s":0.01,"mem_mb":1.1,"disk_size":"20M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.01,"mem_mb":1.1,"disk_size":"20M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.03,"mem_mb":1.2,"disk_size":"21.4M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.04,"mem_mb":1.2,"disk_size":"21.4M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.7,"import_time_s":0.02,"mem_mb":1.2,"disk_size":"22M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.02,"mem_mb":1.2,"disk_size":"22M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.02,"mem_mb":0.9,"disk_size":"13.1M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.02,"mem_mb":0.9,"disk_size":"13.1M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.02,"mem_mb":0.9,"disk_size":"14M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.02,"mem_mb":0.9,"disk_size":"14M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.02,"mem_mb":1.1,"disk_size":"12.9M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.02,"mem_mb":1.1,"disk_size":"12.8M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.02,"mem_mb":0.9,"disk_size":"13M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.02,"mem_mb":0.9,"disk_size":"13M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.02,"mem_mb":0.8,"disk_size":"18.7M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.02,"mem_mb":0.8,"disk_size":"18.7M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.8,"import_time_s":0.01,"mem_mb":0.8,"disk_size":"19M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"mutagen","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":0.01,"mem_mb":0.8,"disk_size":"19M"}]}}