Встроить обложку в аудиофайлы
Добавляет обложку в MP3, FLAC и M4A, беря общий файл или cover.jpg из папки альбома.
Что делает скрипт
Скрипт находит изображение рядом с треком или использует путь из --cover и записывает его в теги. Поддерживаются APIC для MP3, Picture для FLAC и covr для MP4. Без --apply показывается только список изменений, существующие обложки заменяются осознанно.
- Замена обложки меняет теги файлов. Проверьте предпросмотр.
Быстрый старт
python embed_cover.py --dir ~/Music --cover cover.jpg
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python embed_cover.py --dir ~/Musicpython embed_cover.py --dir ./album --cover cover.jpg --applypython embed_cover.py --dir D:\Music --apply
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install mutagen
python3 -m pip install mutagen
python3 -m pip install mutagen
embed_cover.py
#!/usr/bin/env python3
"""Встраивает обложку в аудиофайлы."""
from __future__ import annotations
import argparse
from pathlib import Path
from mutagen.flac import FLAC, Picture
from mutagen.id3 import APIC, ID3, ID3NoHeaderError
from mutagen.mp4 import MP4, MP4Cover
AUDIO_EXTENSIONS = {".mp3", ".flac", ".m4a"}
COVER_NAMES = ("cover.jpg", "cover.jpeg", "cover.png", "folder.jpg", "folder.png", "front.jpg", "front.png")
def mime_for(path: Path) -> str:
return "image/png" if path.suffix.lower() == ".png" else "image/jpeg"
def find_cover(folder: Path) -> Path | None:
for name in COVER_NAMES:
candidate = folder / name
if candidate.is_file():
return candidate
return None
def embed(path: Path, cover: Path, data: bytes, mime: str) -> None:
suffix = path.suffix.lower()
if suffix == ".mp3":
try:
tags = ID3(path)
except ID3NoHeaderError:
tags = ID3()
tags.delall("APIC")
tags.add(APIC(encoding=3, mime=mime, type=3, desc="Cover", data=data))
tags.save(path, v2_version=3)
elif suffix == ".flac":
audio = FLAC(path)
audio.clear_pictures()
picture = Picture()
picture.type = 3
picture.mime = mime
picture.desc = "Cover"
picture.data = data
audio.add_picture(picture)
audio.save()
elif suffix == ".m4a":
audio = MP4(path)
image_format = MP4Cover.FORMAT_PNG if mime == "image/png" else MP4Cover.FORMAT_JPEG
audio["covr"] = [MP4Cover(data, imageformat=image_format)]
audio.save()
else:
raise ValueError(f"Формат не поддерживается: {suffix}")
def main() -> int:
parser = argparse.ArgumentParser(description="Встроить обложку в аудио")
parser.add_argument("--dir", type=Path, required=True, help="Папка с музыкой")
parser.add_argument("--cover", type=Path, help="Общий файл обложки")
parser.add_argument("--apply", action="store_true", help="Записать изменения")
args = parser.parse_args()
root = args.dir.expanduser().resolve()
if not root.is_dir():
parser.error(f"Папка не найдена: {root}")
common_cover = args.cover.expanduser().resolve() if args.cover else None
if common_cover and not common_cover.is_file():
parser.error(f"Обложка не найдена: {common_cover}")
changed = 0
skipped = 0
for path in sorted(root.rglob("*")):
if not path.is_file() or path.suffix.lower() not in AUDIO_EXTENSIONS:
continue
cover = common_cover or find_cover(path.parent)
if cover is None:
print(f"Нет обложки: {path}")
skipped += 1
continue
mime = mime_for(cover)
data = cover.read_bytes()
print(f"{path.name}: обложка {cover.name} ({len(data)} байт)")
if args.apply:
try:
embed(path, cover, data, mime)
except Exception as error:
print(f"Ошибка записи {path}: {error}")
skipped += 1
continue
changed += 1
mode = "обновлено" if args.apply else "будет обновлено"
print(f"Итого {mode}: {changed}, пропущено: {skipped}")
if not args.apply:
print("Это предпросмотр. Для записи добавьте --apply.")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.