#!/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())