
Зачем это нужно#
Оригинальный 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).
При запуске 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-стек.
- GitHub репозиторий: github.com/tatarinovms/podsync
- Решение проблем с YouTube cookies: blog.tatarinovms.space/youtubecookies


