Извлечь обложки из медиатеки
Сохраняет встроенные обложки из MP3, FLAC и M4A в отдельную папку с понятными именами.
Что делает скрипт
Скрипт читает встроенные изображения через mutagen и раскладывает их в каталог covers. Имена строятся из имени трека и расширения картинки, поэтому альбомные обложки не теряются. Оригиналы не изменяются, существующие файлы пропускаются без --force.
Быстрый старт
python extract_covers.py --dir ~/Music --out ./covers
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python extract_covers.py --dir ~/Music --out ./coverspython extract_covers.py --dir ./album --out ./artpython extract_covers.py --dir D:\Music --out D:\Covers --force
Что понадобится
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
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.