Найти альбомы без обложек
Проверяет встроенные картинки и файлы cover.jpg, показывая папки, где обложки не хватает.
Что делает скрипт
Скрипт группирует аудиофайлы по папкам и отдельно проверяет теги и типичные файлы обложек. В отчёт попадают альбомы без файловой обложки, где хотя бы у одного трека нет изображения. Ничего не изменяется, есть вывод в JSON для дальнейшей обработки.
Быстрый старт
python missing_covers.py --dir ~/Music
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python missing_covers.py --dir ~/Musicpython missing_covers.py --dir ~/Music --json report.jsonpython missing_covers.py --dir D:\Music --json missing.json
Что понадобится
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
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.