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"] = "新しい曲のタイトル"
audio["TPE1"] = "新しいアーティスト"

# 変更を永続化する
audio.save()

from mutagen import File

path = "path/to/file.mp3"  # .flac, .m4a, .ogg でも動作します

audio = File(path)
if audio is None:
    raise ValueError("サポートされていないか、読み込めないファイルです")

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)
print("ジャンル:", 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_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_id と一致する必要があります
    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"チャプター {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("分割完了。")

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はタプルを使用します。他のフォーマットは文字列のままにします。
    audio.save()

print("トラックが正規化されました。")