Медиатека

Извлечь обложки из медиатеки

Сохраняет встроенные обложки из MP3, FLAC и M4A в отдельную папку с понятными именами.

Python Windows macOS Linux Новичок
Скачать extract_covers.py
Описание

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

Скрипт читает встроенные изображения через mutagen и раскладывает их в каталог covers. Имена строятся из имени трека и расширения картинки, поэтому альбомные обложки не теряются. Оригиналы не изменяются, существующие файлы пропускаются без --force.

Запуск

Быстрый старт

python extract_covers.py --dir ~/Music --out ./covers

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python extract_covers.py --dir ~/Music --out ./covers
  • python extract_covers.py --dir ./album --out ./art
  • python extract_covers.py --dir D:\Music --out D:\Covers --force
Зависимости

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

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
Исходник

extract_covers.py

#!/usr/bin/env python3
"""Извлекает встроенные обложки в отдельную папку."""
from __future__ import annotations

import argparse
from pathlib import Path

from mutagen.flac import FLAC
from mutagen.id3 import ID3, ID3NoHeaderError
from mutagen.mp4 import MP4, MP4Cover

AUDIO_EXTENSIONS = {".mp3", ".flac", ".m4a"}
MIME_EXT = {"image/jpeg": ".jpg", "image/jpg": ".jpg", "image/png": ".png", "image/webp": ".webp"}


def cover_items(path: Path):
    suffix = path.suffix.lower()
    if suffix == ".mp3":
        try:
            tags = ID3(path)
        except ID3NoHeaderError:
            return []
        return [(frame.data, frame.mime) for frame in tags.getall("APIC")]
    if suffix == ".flac":
        return [(picture.data, picture.mime) for picture in FLAC(path).pictures]
    if suffix == ".m4a":
        tags = MP4(path).tags or {}
        items = []
        for cover in tags.get("covr", []):
            mime = "image/png" if cover.imageformat == MP4Cover.FORMAT_PNG else "image/jpeg"
            items.append((bytes(cover), mime))
        return items
    return []


def main() -> int:
    parser = argparse.ArgumentParser(description="Извлечь обложки из аудио")
    parser.add_argument("--dir", type=Path, required=True, help="Папка с музыкой")
    parser.add_argument("--out", type=Path, default=Path("covers"), help="Папка для обложек")
    parser.add_argument("--force", action="store_true", help="Перезаписать существующие файлы")
    args = parser.parse_args()

    root = args.dir.expanduser().resolve()
    if not root.is_dir():
        parser.error(f"Папка не найдена: {root}")
    output = args.out.expanduser().resolve()
    output.mkdir(parents=True, exist_ok=True)

    saved = 0
    skipped = 0
    for path in sorted(root.rglob("*")):
        if not path.is_file() or path.suffix.lower() not in AUDIO_EXTENSIONS:
            continue
        try:
            items = cover_items(path)
        except Exception as error:
            print(f"Не прочитано: {path}: {error}")
            skipped += 1
            continue
        if not items:
            continue
        for index, (data, mime) in enumerate(items, start=1):
            extension = MIME_EXT.get(str(mime).lower(), ".jpg")
            suffix = "" if len(items) == 1 else f"-{index}"
            target = output / f"{path.stem}{suffix}{extension}"
            if target.exists() and not args.force:
                print(f"Пропуск: {target}")
                skipped += 1
                continue
            target.write_bytes(data)
            print(f"Сохранено: {target}")
            saved += 1

    print(f"Итого сохранено: {saved}, пропущено: {skipped}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

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

CLI 1.0.0

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

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

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

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

Категория

Медиатека

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