Медиатека

Каталог подкастов

Собирает выпуски по дате, шоу и названию, помогает увидеть пропуски и старые эпизоды.

Python Windows macOS Linux Новичок
Скачать podcast_catalog.py
Описание

Что делает скрипт

Скрипт читает теги MP3, M4A и FLAC, определяет подкаст по альбому или папке и сортирует выпуски по дате. В отчёт входят размер, длительность и путь к файлу. Коллекция не меняется, данные остаются локальными.

Запуск

Быстрый старт

python podcast_catalog.py --dir ~/Podcasts --csv episodes.csv

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python podcast_catalog.py --dir ~/Podcasts
  • python podcast_catalog.py --dir ~/Podcasts --csv episodes.csv
  • python podcast_catalog.py --dir D:\Podcasts --json episodes.json
Зависимости

Что понадобится

Python 3.10+ Интерпретатор и стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
mutagen Чтение и запись тегов аудио
Windows py -m pip install mutagen
macOS python3 -m pip install mutagen
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get media-podcast-catalog
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Медиатека

Плейлисты, метаданные, обложки, субтитры и порядок в коллекциях.