Каталог подкастов
Собирает выпуски по дате, шоу и названию, помогает увидеть пропуски и старые эпизоды.
Что делает скрипт
Скрипт читает теги MP3, M4A и FLAC, определяет подкаст по альбому или папке и сортирует выпуски по дате. В отчёт входят размер, длительность и путь к файлу. Коллекция не меняется, данные остаются локальными.
Быстрый старт
python podcast_catalog.py --dir ~/Podcasts --csv episodes.csv
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python podcast_catalog.py --dir ~/Podcastspython podcast_catalog.py --dir ~/Podcasts --csv episodes.csvpython podcast_catalog.py --dir D:\Podcasts --json episodes.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
podcast_catalog.py
#!/usr/bin/env python3
"""Собирает каталог выпусков подкастов."""
from __future__ import annotations
import argparse
import csv
import json
from datetime import datetime
from pathlib import Path
from mutagen import File as MutagenFile
AUDIO_EXTENSIONS = {".mp3", ".m4a", ".aac", ".ogg", ".opus", ".flac"}
def tag(tags, key: str) -> str:
value = tags.get(key)
if isinstance(value, list):
value = value[0] if value else ""
return "" if value is None else str(value).strip()
def main() -> int:
parser = argparse.ArgumentParser(description="Каталог подкастов")
parser.add_argument("--dir", type=Path, required=True, help="Папка с подкастами")
parser.add_argument("--csv", type=Path, help="Сохранить CSV")
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}")
rows = []
for path in sorted(root.rglob("*")):
if not path.is_file() or path.suffix.lower() not in AUDIO_EXTENSIONS:
continue
try:
audio = MutagenFile(path, easy=True)
except Exception as error:
print(f"Не прочитано: {path}: {error}")
continue
if audio is None:
continue
tags = audio.tags or {}
show = tag(tags, "album") or path.parent.name
title = tag(tags, "title") or path.stem
date = tag(tags, "date")[:10] or tag(tags, "year")
if not date:
date = datetime.fromtimestamp(path.stat().st_mtime).strftime("%Y-%m-%d")
duration = float(getattr(audio.info, "length", 0.0))
rows.append(
{
"date": date,
"show": show,
"title": title,
"minutes": round(duration / 60, 1),
"size_mb": round(path.stat().st_size / (1024 * 1024), 1),
"file": str(path.relative_to(root)),
}
)
if not rows:
print("Подкасты не найдены.")
return 1
rows.sort(key=lambda item: (item["show"].lower(), item["date"]))
for row in rows[:30]:
print(f"{row['date']} | {row['show']} | {row['title']}")
if len(rows) > 30:
print(f"И ещё {len(rows) - 30} выпусков.")
if args.csv:
target = args.csv.expanduser()
target.parent.mkdir(parents=True, exist_ok=True)
with target.open("w", encoding="utf-8", newline="") as handle:
writer = csv.DictWriter(handle, fieldnames=list(rows[0]))
writer.writeheader()
writer.writerows(rows)
print(f"CSV: {target}")
if args.json:
target = args.json.expanduser()
target.parent.mkdir(parents=True, exist_ok=True)
target.write_text(json.dumps(rows, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
print(f"JSON: {target}")
print(f"Выпусков: {len(rows)}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.