Медиатека

Встроить обложку в аудиофайлы

Добавляет обложку в MP3, FLAC и M4A, беря общий файл или cover.jpg из папки альбома.

Python Windows macOS Linux Продвинутый
Скачать embed_cover.py
Описание

Что делает скрипт

Скрипт находит изображение рядом с треком или использует путь из --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 ~/Music
  • python embed_cover.py --dir ./album --cover cover.jpg --apply
  • python embed_cover.py --dir D:\Music --apply
Зависимости

Что понадобится

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
mutagen Чтение и запись тегов аудио
Windows py -m pip install mutagen
macOS python3 -m pip install mutagen
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get media-embed-cover
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Медиатека

Плейлисты, метаданные, обложки, субтитры и порядок в коллекциях.