↓ Перейти к основному содержимому

Прокачиваем Podsync: веб-админка, Catppuccin, поддержка VK Видео и MCP для ИИ-агентов

··1111 слов·6 минут·
Оглавление
logo

Зачем это нужно
#

Оригинальный Podsync — отличная утилита, которая исправно забирает ролики с YouTube и заворачивает их в стандартный аудио-подкаст (RSS-фид). Но проект практически замер, а потребности для меня за последнее время сильно изменились:

  • Есть контент в VK Видео и Rutube, а поддержки этих платформ в апстриме не было.
  • YouTube всё агрессивнее блокирует серверные IP и требует авторизацию ботов (Sign in to confirm you're not a bot).
  • Любое добавление нового канала требовало ручной правки config.toml и перезапуска демона.
  • Хотелось управлять библиотекой с любого устройства — быстро скопировать RSS, накидать отдельные ролики в персональный выпуск, закинуть локальную аудиокнигу или попросить AI-агента в OpenCode добавить подписку.

Поэтому я собрал собственный форк Podsync, куда навайбкодил всё, чего так не хватало.

Что нового в форке
#

1. Встроенная веб-админка (/admin)
#

В бинарник вшита адаптивная панель управления без внешних Node.js-зависимостей:

  • Сайдбар и организация: разделы LIBRARY (Podcasts со счётчиком лент, Personal feeds, Audiobooks, Activity с индикатором ошибок) и SETTINGS (API keys, Downloader, System & storage, MCP server).
  • Режимы отображения: переключение между наглядной сеткой карточек (Grid) и компактным списком (List) с сохранением выбора в localStorage.
  • Быстрая подписка (Subscribe Modal): кнопка копирования RSS в буфер в один клик, генератор QR-кода для камеры смартфона и прямые deep-link кнопки в Apple Podcasts, Pocket Casts и Overcast.
  • Выделенная страница подкаста: обложка, встроенный веб-плеер для аудио и видео, поиск по сериям, фильтры статусов (Downloaded, Pending, Errors, Cleaned), фильтры по длительности (< 15 мин, 15–60 мин, > 60 мин) и кнопка Retry для повторного скачивания упавших выпусков.
  • Кастомные обложки: загрузка своего изображения (JPEG, PNG, WebP) прямо со страницы подкаста с живым предпросмотром.
  • Управление фидами: добавление новых каналов и плейлистов на лету (автоматически пишутся в config.toml и встают в очередь), ручной запуск обновления и удаление с очисткой файлов.
  • Темы оформления: палитра Catppuccin Mocha и Latte с бесшовным переключением.

2. Поддержка VK Видео и Rutube
#

  • VK Видео: превращаем в подкасты каналы, сообщества, страницы авторов и плейлисты из VK Видео (vkvideo.ru, vk.com, vk.ru). Достаточно один раз указать API-токен через веб-интерфейс или переменную PODSYNC_VKVIDEO_API_KEY. Причём админка сама достаёт access_token, если вставить полный URL редиректа OAuth.
  • Rutube: полная поддержка каналов, плейлистов и отдельных роликов (rutube.ru/channel/..., rutube.ru/plst/..., rutube.ru/video/...). Работает из коробки через yt-dlp без каких-либо API-ключей.

3. Персональные ленты (Personal Feeds)
#

В форк встроен движок универсальных персональных подкастов:

  • Audio + Video в одном фиде: в ленте могут одновременно лежать как аудиозаписи, так и видеоролики с корректными MIME-типами <enclosure>.
  • Любые источники: добавление отдельных роликов по ссылке (YouTube, Rutube, VK Видео, Vimeo, SoundCloud), прямых ссылок на медиафайлы (MP3, MP4, FLAC, OGG, WebM), локальных файлов на сервере (file_path) или прямая загрузка файлов с компьютера до 4 ГиБ через браузер с автоконвертацией в MP3/MP4 через ffmpeg.
  • Совместное использование без дублирования: серии можно копировать в другие ленты (общий медиафайл на диске со счётчиком ссылок) или перемещать с сохранением GUID.
  • Переименование на лету: редактирование названий эпизодов прямо из админки с немедленным перестроением RSS XML.

4. Локальные аудиокниги
#

Podsync умеет превращать папки с аудиофайлами на сервере в полноценные сериальные подкасты:

  • Стандарт сериалов Podcast 2.0: теги <itunes:type>serial</itunes:type> и нумерация глав <itunes:episode>N</itunes:episode>, благодаря чему плееры воспроизводят главы строго по порядку от 1 до N.
  • Естественная сортировка (Natural Sort): треки сортируются по человеческой логике (01, 02 … 10), а не алфавитной (1, 10, 2).
  • Обложки: автоматическое извлечение встроенных картинок из тегов ID3/APIC или файлов cover.jpg / folder.jpg в папке книги.
  • Автодискавери в 1 клик: автообнаружение папок в директории [audiobooks].dir и импорт в ленту без нагрузки на CPU по cron.

5. Управление cookies и обход блокировок YouTube
#

Для борьбы с проверками YouTube в веб-интерфейс вынесен раздел Downloader & Cookies:

  • Вставка и сохранение cookies.txt (Netscape формат) прямо из браузера или автоэкстракция сессионных cookies из установленных браузеров (Chrome, Firefox, Safari).
  • Настройка HTTP/SOCKS5 прокси для трафика yt-dlp.
  • Встроенный URL-тестер для быстрой проверки извлечения метаданных перед сохранением настроек.
  • Фоновое автообновление yt-dlp каждые 24 часа.

6. Безопасность и системные логи
#

  • Brute-Force Protection: встроенный sliding-window rate-limiter, защищающий вход в админку и HTTP Basic Auth от подбора паролей (max_attempts, window, lockout).
  • Логи в реальном времени: кольцевой буфер системных логов прямо в админке с автообновлением, поиском, фильтрацией по уровням (DEBUG, INFO, WARN, ERROR) и скачиванием в один клик.
  • Метрики: мониторинг памяти, занятого и свободного места в папке данных и проверка доступности yt-dlp и ffmpeg.

7. Нативный MCP-сервер для ИИ-агентов
#

Встроен сервер Model Context Protocol (MCP) с 28 инструментами. Теперь любой LLM-ассистент (OpenCode, Claude Desktop, Cursor, Antigravity) умеет управлять вашей медиатекой:

  • Смотреть список фидов, личных лент и аудиокниг (list_feeds, list_personal_feeds, list_audiobook_dirs).
  • Добавлять новые каналы, серии и импортировать книги прямо по ссылке из чата (add_feed, add_personal_episode, import_audiobook).
  • Анализировать ошибки и перезапускать упавшие загрузки (get_download_errors, retry_episode).
  • Проверять системные метрики и логи (get_system_stats, get_system_logs).
  • Работать как локально через stdio (podsync --mcp), так и удалённо по SSE (/mcp/sse).
Tip

При запуске podsync --mcp утилита автоматически проверяет работающий демон на локальном порту и проксирует JSON-RPC через него. Поэтому никаких конфликтов блокировки BadgerDB не происходит.

Быстрый запуск
#

Вариант 1. Готовый бинарник
#

Скачиваем скомпилированный релиз под вашу архитектуру из GitHub Releases:

mkdir -p /opt/podsync/{bin,data,db}
cd /opt/podsync

# Пример для Linux x86_64:
curl -L -o bin/podsync "https://github.com/tatarinovms/podsync/releases/latest/download/podsync-linux-amd64"
chmod +x bin/podsync

Вариант 2. Docker Compose
#

services:
  podsync:
    image: ghcr.io/tatarinovms/podsync:latest
    container_name: podsync
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - PODSYNC_ADMIN_ENABLED=true
      - PODSYNC_ADMIN_USERNAME=admin
      - PODSYNC_ADMIN_PASSWORD=your-secure-password
      - PODSYNC_VKVIDEO_API_KEY=your-vk-token
    volumes:
      - ./config.toml:/app/config.toml
      - ./data:/app/data
      - ./db:/app/db

Запуск:

docker compose up -d

Вариант 3. Сборка из исходников
#

Вам понадобятся go (1.22+), ffmpeg и yt-dlp:

git clone https://github.com/tatarinovms/podsync.git
cd podsync
make

Бинарник будет лежать в ./bin/podsync.

Настройка конфигурации (config.toml)
#

Создаём config.toml:

[server]
port = 8080
hostname = "https://podcast.example.com"

[server.admin]
enabled = true
username = "admin"
password = "your-secure-password"

[storage]
  [storage.local]
  data_dir = "/app/data"

[database]
  dir = "/app/db"

[audiobooks]
dir = "/app/data/audiobooks"

[tokens]
youtube = "YOUR_YOUTUBE_API_KEY"
# vkvideo = "YOUR_VK_TOKEN"

[cleanup]
keep_last = 3

[downloader]
self_update = true
timeout = 30

Переходим в браузере по адресу http://<ip>:8080/admin/ — и вся библиотека перед вами.

Подключение к OpenCode и другим агентам через MCP
#

В opencode.json (или ~/.config/opencode/opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "podsync": {
        "type": "local",
        "command": [
          "/opt/podsync/bin/podsync",
          "--config",
          "/opt/podsync/config.toml",
          "--mcp"
        ],
        "enabled": true
      }
    }
  }
}

Для Claude Desktop или Cursor конфиг выглядит аналогично:

{
  "mcpServers": {
    "podsync": {
      "command": "/opt/podsync/bin/podsync",
      "args": [
        "--config",
        "/opt/podsync/config.toml",
        "--mcp"
      ]
    }
  }
}

Проверяем список серверов:

opencode mcp list

Теперь достаточно написать агенту в чат:

  • «Добавь этот плейлист из VK Видео в Podsync и скачай свежие выпуски»
  • «Создай персональный подкаст “Интервью” и закинь туда этот ролик с Rutube»
  • «Посмотри, почему упала загрузка на канале X, и перезапусти серию»

И агент сделает всё сам через нативные инструменты.

Итог
#

Podsync превратился из узкоспециализированного скрипта для YouTube в полноценный self-hosted медиакомбайн с красивым интерфейсом, поддержкой российских площадок, аудиокниг, личных подборок и интеграцией в современный AI-стек.

Related