video-to-notes CLI
CLI и скилл для Codex превращает видео с YouTube и Bilibili в расшифровку и конспект с метками времени, с выгрузкой в Notion.
- 113 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установщик ставит зависимости и модель Whisper на вашу машину.
- При публикации в Notion в сервис уходят расшифровка и конспект.
Установка
- Работает в
Ручная установка
git clone https://github.com/KIRVO-REPORTING/video-to-notes.git
cd video-to-notes
./install.shКоманды из раздела быстрой установки для macOS и Linux. Для Windows PowerShell есть `install.ps1`. Скилл Codex копируют отдельно из `codex-skill/`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик ставит зависимости и модель Whisper на вашу машину.
- При публикации в Notion в сервис уходят расшифровка и конспект.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
video-to-notes скачивает субтитры видео через `yt-dlp` и запускает локальный Whisper, только если подходящих субтитров нет. Из расшифровки получается отчет в HTML с кликабельными метками времени и конспектом, привязанным к источнику. Команды `process`, `finalize`, `publish-notion` и `publish-obsidian` доводят результат до базы знаний, а `serve --open` открывает локальную панель со всеми отчетами. Скилл в каталоге `codex-skill` учит Codex вызывать CLI и писать резюме на основе расшифровки.
Для кого. Студенты, исследователи и авторы, которые конспектируют длинные лекции, интервью и доклады с YouTube и Bilibili.
Подходит, если
- Нужен конспект двухчасовой лекции с метками времени.
- Видео без субтитров надо расшифровать локально.
- Заметки по видео должны попасть в Obsidian или Notion.
- Агент пишет резюме ролика и должен ссылаться на минуты.
Не подходит, если
- Нужен постраничный дословный перевод всего ролика.
- Видео закрыто для скачивания, а обход ограничений не предполагается.
- Ресурсов машины не хватает на локальную модель Whisper.
Пример запроса к агенту
Сделай конспект этого видео на YouTube с метками времени и положи отчет в Obsidian.Ограничения
Установка идет скриптом `install.sh` или `install.ps1` из клона, он подготавливает Python, `ffmpeg` и модель Whisper, на что уходит время и место на диске. Скилл описан для Codex, для других клиентов путь установки подбирают вручную. Для некоторых видео нужны cookies браузера через `--cookies-from-browser`, это передает сессию `yt-dlp`. Резюме пишет модель, проверяйте его по меткам времени. Для YouTube и Bilibili достаточно ссылки, другие сайты работают, если их поддерживает `yt-dlp`.
Как отключить. Удалите каталог `~/.codex/skills/video-to-notes`, каталог клона с окружением `.venv` и отчеты в рабочей папке. Токен Notion отзовите в настройках интеграции.
Частые вопросы
Когда включается Whisper?
Только когда у видео нет подходящих субтитров. Принудительная транскрибация включается флагом `--force-transcribe`, а `--no-transcribe-fallback` ее запрещает.
Как передать отчет в Notion?
Добавьте `--publish-notion` к `finalize` или выполните `video-to-notes publish-notion` для готовой папки. Если Notion подключен как MCP, агент может использовать его.
Остался ли старый алиас?
Да, команда `ytlt` работает как псевдоним, но документация использует `video-to-notes`.
Где хранятся отчеты?
В рабочей папке, которую задает `--workspace`. Там лежат расшифровка, HTML-отчет и индекс для локальной панели.
Что проверяет `doctor`?
Окружение: Python, `ffmpeg`, `yt-dlp` и выбранный бэкенд Whisper. Запускайте его до первой обработки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл берет субтитры YouTube-видео и собирает HTML-отчет с выводами, таймкодами и встроенным плеером
Скилл переносит избранные видео Douyin в локальную базу Markdown или Obsidian с расшифровкой речи и ежедневной сводкой.
Скилл превращает ролики и фотопосты Douyin в тематические заметки Obsidian с локальной расшифровкой и индексом.
Превращает ссылку на видео Bilibili или YouTube либо локальный файл в расшифровку, аннотацию и конспект Markdown
CLI хранит скиллы агентов в базе Notion: общий каталог, установка нужных на машину, синхронизация и публикация для команды
Скилл для Codex собирает из ваших лекций, задач и экзаменов конспекты в Obsidian с выводами формул и ступенчатой практикой.
Коротко о README
Субтитры идут первыми, локальный Whisper нужен лишь как запасной путь. Отчеты хранятся у вас в рабочей папке, а выгрузка в Notion и Obsidian остается по желанию.