Python Mutagen Snippets

pip install --upgrade mutagen

from mutagen.mp3 import MP3
from mutagen.id3 import ID3NoHeaderError

path = "pfad/zur/datei.mp3"

try:
    audio = MP3(path, ID3=ID3)
except ID3NoHeaderError:
    audio = MP3(path)

# Tag lesen
title = audio.get("TIT2") or audio.get("\xa9nam")  # ID3 v2 oder iTunes-Stil
print(title)

# Tag schreiben (erstellen oder aktualisieren)
audio["TIT2"] = "Neuer Songtitel"
audio["TPE1"] = "Neuer Künstler"

# Änderungen persistent machen
audio.save()

from mutagen import File

path = "pfad/zur/datei.mp3"  # funktioniert auch mit .flac, .m4a, .ogg

audio = File(path)
if audio is None:
    raise ValueError("Nicht unterstützte oder nicht lesbare Datei")

title = audio.get("TITLE") or audio.get("\xa9nam") or audio.get("TIT2")
artist = audio.get("ARTIST") or audio.get("\xa9ART") or audio.get("TPE1")
album = audio.get("ALBUM") or audio.get("\xa9alb") or audio.get("TALB")
date = audio.get("DATE") or audio.get("\xa9day") or audio.get("TDRC")

print(title, artist, album, date)

from mutagen import File

audio = File("pfad/zur/datei.mp3")
artists = audio.get("ARTIST") or audio.get("\xa9ART") or audio.get("TPE1")
genres = audio.get("GENRE") or audio.get("\xa9gen") or audio.get("TCON")

# Mutagen gibt eine Liste oder None zurück; sicher auffangen
artists = artists if isinstance(artists, list) else ([artists] if artists else [])
genres = genres if isinstance(genres, list) else ([genres] if genres else [])

print("Künstler:", artists)
print("Genres:", genres)

# Mehrwertige Werte schreiben ist dasselbe – einfach eine Liste zuweisen
audio["TPE1"] = ["Alice", "Bob"]
audio.save()

from mutagen.mp3 import MP3
from mutagen.id3 import APIC, ID3

audio = MP3("pfad/zur/datei.mp3", ID3=ID3)
audio.add_tags()  # sicherstellen, dass ein ID3-Header existiert

with open("cover.jpg", "rb") as f:
    cover_data = f.read()

# ID3: ein Frontcover in JPEG anhängen
audio.tags.add(APIC(
    encoding=3,      # UTF-8
    mime="image/jpeg",
    type=3,          # Frontcover
    desc="Cover",
    data=cover_data
))
audio.save()

# Für MP4/M4A:
# from mutagen.mp4 import MP4
# mp4 = MP4("pfad/zur/datei.m4a")
# mp4["covr"] = [MP4.MP4Cover(cover_data, imageformat=MP4.FORMAT_JPEG)]
# mp4.save()

from mutagen import File

audio = File("pfad/zur/datei.flac")
length_seconds = audio.info.length if getattr(audio, "info", None) else None
print("Länge:", length_seconds)

# Schön formatiert mm:ss ausgeben
if length_seconds:
    mins, secs = divmod(int(length_seconds), 60)
    print(f"{mins:02d}:{secs:02d}")

# pip install mutagen[chapters]  # falls für Cuesheet-Unterstützung benötigt
from mutagen.mp3 import MP3
from mutagen.id3 import CHAP, CTOC, ID3

audio = MP3("pfad/zum/album.mp3", ID3=ID3)

# Eine übergeordnete Inhaltsübersicht mit Kapitelelementen erstellen
toc = CTOC(
    elem_id=["toc"],
    flags=0x02,  # übergeordnet
    child_elem_ids=["ch0", "ch1", "ch2"],  # müssen mit Kapitelelement-IDs übereinstimmen
    sort_index=0
)
audio.tags.add(toc)

# Einfache Kapitelmarkierungen bei 0s, 120s, 300s hinzufügen
chapters = [0, 120, 300]
for i, start in enumerate(chapters):
    end = chapters[i + 1] if i + 1 < len(chapters) else None
    audio.tags.add(CHAP(
        elem_id=f"ch{i}",
        start_ms=start * 1000,
        end_ms=(end * 1000) if end else None,
        tags={"TIT2": f"Kapitel {i + 1}"}
    ))

audio.save()

# MP4 (M4A)-Kapitel sind nicht trivial und werden manchmal als Textspuren geschrieben.
# Viele Player bevorzugen es, Spuren aufzuteilen und neu zu taggen, anstatt MP4-Kapitel direkt zu schreiben.

import subprocess
from pathlib import Path
from mutagen import File
from mutagen.mp3 import MP3
from mutagen.id3 import ID3

input_path = "pfad/zum/album.flac"
out_dir = Path("splits")
out_dir.mkdir(exist_ok=True)

# Beispiel-Zeitstempel (mm:ss)
chapters = ["00:00", "02:00", "05:00", "07:30"]

audio = File(input_path)
title = (audio.get("TITLE") or audio.get("\xa9nam") or ["Track"]).value
artist = (audio.get("ARTIST") or audio.get("\xa9ART") or ["Artist"]).value

for i in range(len(chapters) - 1):
    start = chapters[i]
    end = chapters[i + 1]
    out_path = out_dir / f"track_{i+1:02d}.mp3"

    # Mit ffmpeg schneiden (keine Neukodierung; Streams kopieren)
    cmd = [
        "ffmpeg", "-y",
        "-i", str(input_path),
        "-ss", start,
        "-to", end,
        "-c", "copy",
        str(out_path)
    ]
    subprocess.run(cmd, check=True)

    # Tags auf die neue Datei anwenden
    track = MP3(str(out_path), ID3=ID3)
    track.add_tags()
    track["TIT2"] = f"{title} (Teil {i+1})"
    track["TPE1"] = artist
    track["TRACK"] = f"{i+1}/{len(chapters)-1}"
    track.save()

print("Aufteilen abgeschlossen.")

from pathlib import Path
from mutagen import File
import shutil

root = Path("pfad/zum/album")
files = sorted([p for p in root.iterdir() if p.suffix.lower() in (".mp3", ".flac", ".m4a", ".ogg")])

for idx, path in enumerate(files, start=1):
    audio = File(path)
    if not audio:
        continue

    # Bevorzugt bestehende TRACK; fällt auf Index zurück
    track = audio.get("TRACK") or audio.get("trkn") or [idx]
    # Normalisieren auf aktuelle Track-Nummer (Gesamtanzahl für Umbenennung ignorieren)
    cur = track[0] if isinstance(track, list) else track

    new_name = f"{cur:02d} - {path.name.split(' - ', 1)[-1] if ' - ' in path.name else path.name}"
    new_path = path.with_name(new_name)

    if new_path != path:
        shutil.move(str(path), str(new_path))

    # TRACK sicher aktualisieren
    audio["TRACK"] = f"{idx}/{len(files)}"
    # MP4 verwendet ein Tupel für trkn; andere Formate als Zeichenkette belassen
    audio.save()

print("Tracks normalisiert.")