Медиатека

Найти альбомы без обложек

Проверяет встроенные картинки и файлы cover.jpg, показывая папки, где обложки не хватает.

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

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

Скрипт группирует аудиофайлы по папкам и отдельно проверяет теги и типичные файлы обложек. В отчёт попадают альбомы без файловой обложки, где хотя бы у одного трека нет изображения. Ничего не изменяется, есть вывод в JSON для дальнейшей обработки.

Запуск

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

python missing_covers.py --dir ~/Music

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

Примеры

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

  • python missing_covers.py --dir ~/Music
  • python missing_covers.py --dir ~/Music --json report.json
  • python missing_covers.py --dir D:\Music --json missing.json
Зависимости

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

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

missing_covers.py

#!/usr/bin/env python3
"""Ищет альбомы без встроенных и файловых обложек."""
from __future__ import annotations

import argparse
import json
from collections import defaultdict
from pathlib import Path

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

AUDIO_EXTENSIONS = {".mp3", ".flac", ".m4a"}
SIDECAR_EXTENSIONS = {".jpg", ".jpeg", ".png", ".webp"}
SIDECAR_NAMES = {"cover", "folder", "front", "album", "artwork"}


def has_embedded_cover(path: Path) -> bool:
    suffix = path.suffix.lower()
    if suffix == ".mp3":
        try:
            return bool(ID3(path).getall("APIC"))
        except ID3NoHeaderError:
            return False
    if suffix == ".flac":
        return bool(FLAC(path).pictures)
    if suffix == ".m4a":
        tags = MP4(path).tags or {}
        return bool(tags.get("covr"))
    return False


def main() -> int:
    parser = argparse.ArgumentParser(description="Найти альбомы без обложек")
    parser.add_argument("--dir", type=Path, required=True, help="Папка с музыкой")
    parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
    args = parser.parse_args()

    root = args.dir.expanduser().resolve()
    if not root.is_dir():
        parser.error(f"Папка не найдена: {root}")

    folders: dict[Path, list[Path]] = defaultdict(list)
    for path in sorted(root.rglob("*")):
        if path.is_file() and path.suffix.lower() in AUDIO_EXTENSIONS:
            folders[path.parent].append(path)

    report = []
    for folder, files in sorted(folders.items()):
        sidecar = any(
            item.is_file()
            and item.suffix.lower() in SIDECAR_EXTENSIONS
            and item.stem.lower() in SIDECAR_NAMES
            for item in folder.iterdir()
        )
        if sidecar:
            continue
        without = []
        for path in files:
            try:
                if not has_embedded_cover(path):
                    without.append(path.name)
            except Exception:
                without.append(path.name)
        if without:
            report.append(
                {
                    "folder": str(folder),
                    "tracks": len(files),
                    "without_cover": without,
                }
            )

    if not report:
        print("Все альбомы с обложками.")
        return 0

    for item in report:
        print(f"{item['folder']}: {len(item['without_cover'])} из {item['tracks']} без обложки")
        for name in item["without_cover"][:5]:
            print(f"  - {name}")
    print(f"Итого проблемных альбомов: {len(report)}")

    if args.json:
        target = args.json.expanduser()
        target.parent.mkdir(parents=True, exist_ok=True)
        target.write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"Отчёт: {target}")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

Медиатека

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