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