Python Mutagen 스니펫

pip install --upgrade mutagen

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

path = "path/to/file.mp3"

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

# 태그 읽기
title = audio.get("TIT2") or audio.get("\xa9nam")  # ID3 v2 또는 iTunes 스타일
print(title)

# 태그 쓰기 (생성 또는 업데이트)
audio["TIT2"] = "New Song Title"
audio["TPE1"] = "New Artist"

# 변경 사항 유지
audio.save()

from mutagen import File

path = "path/to/file.mp3"  # .flac, .m4a, .ogg에서도 작동합니다
audio = File(path)
if audio is None:
    raise ValueError("Unsupported or unreadable file")

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("path/to/file.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은 목록 또는 None을 반환합니다. 안전하게 대체합니다.
artists = artists if isinstance(artists, list) else ([artists] if artists else [])
genres = genres if isinstance(genres, list) else ([genres] if genres else [])

print("Artists:", artists)
print("Genres:", genres)

# 다중 값 쓰기도 동일합니다—그냥 목록을 할당하면 됩니다.
audio["TPE1"] = ["Alice", "Bob"]
audio.save()

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

audio = MP3("path/to/file.mp3", ID3=ID3)
audio.add_tags()  # ID3 헤더가 있는지 확인

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

# ID3: JPEG로 프런트 커버 첨부
audio.tags.add(APIC(
    encoding=3,      # UTF-8
    mime="image/jpeg",
    type=3,          # 프런트 커버
    desc="Cover",
    data=cover_data
))
audio.save()

# MP4/M4A의 경우:
# from mutagen.mp4 import MP4
# mp4 = MP4("path/to/file.m4a")
# mp4["covr"] = [MP4.MP4Cover(cover_data, imageformat=MP4.FORMAT_JPEG)]
# mp4.save()

from mutagen import File

audio = File("path/to/file.flac")
length_seconds = audio.info.length if getattr(audio, "info", None) else None
print("Length:", length_seconds)

# mm:ss 형식으로 보기 좋게 출력
if length_seconds:
    mins, secs = divmod(int(length_seconds), 60)
    print(f"{mins:02d}:{secs:02d}")

# pip install mutagen[chapters]  # 필요한 경우 큐시트 지원용
from mutagen.mp3 import MP3
from mutagen.id3 import CHAP, CTOC, ID3

audio = MP3("path/to/album.mp3", ID3=ID3)

# 챕터 요소를 가진 최상위 목차 생성
toc = CTOC(
    elem_id=["toc"],
    flags=0x02,  # 최상위
    child_elem_ids=["ch0", "ch1", "ch2"],  # 챕터 elem_ids와 일치해야 함
    sort_index=0
)
audio.tags.add(toc)

# 0초, 120초, 300초에 간단한 챕터 마커 추가
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"Chapter {i + 1}"}
    ))

audio.save()

# MP4 (M4A) 챕터는 간단하지 않으며 때로는 텍스트 트랙으로 기록됩니다.
# 많은 플레이어는 MP4 챕터를 직접 쓰는 것보다 트랙을 분할하고 다시 태그하는 것을 선호합니다.

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

input_path = "path/to/album.flac"
out_dir = Path("splits")
out_dir.mkdir(exist_ok=True)

# 예시 타임스탬프 (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"

    # ffmpeg로 슬라이스 (다시 인코딩 없음; 스트림 복사)
    cmd = [
        "ffmpeg", "-y",
        "-i", str(input_path),
        "-ss", start,
        "-to", end,
        "-c", "copy",
        str(out_path)
    ]
    subprocess.run(cmd, check=True)

    # 새 파일에 태그 적용
    track = MP3(str(out_path), ID3=ID3)
    track.add_tags()
    track["TIT2"] = f"{title} (Part {i+1})"
    track["TPE1"] = artist
    track["TRACK"] = f"{i+1}/{len(chapters)-1}"
    track.save()

print("Split complete.")

from pathlib import Path
from mutagen import File
import shutil

root = Path("path/to/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

    # 기존 TRACK를 우선하고, 인덱스로 대체합니다.
    track = audio.get("TRACK") or audio.get("trkn") or [idx]
    # 현재 트랙 번호로 정규화 (이름 변경 시 총 트랙 수는 무시)
    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를 안전하게 업데이트합니다.
    audio["TRACK"] = f"{idx}/{len(files)}"
    # MP4는 trkn에 튜플을 사용합니다. 다른 형식은 문자열로 둡니다.
    audio.save()

print("Tracks normalized.")