Как смотреть YouTube из терминала с ytfzf

Коротко о сути

ytfzf — это набор скриптов для терминала, который ищет видео через API Invidious и стримит их через mpv, используя yt-dlp для загрузки/транскодирования. Инструмент полезен тем, кто предпочитает работать без браузера и хочет меньше трекеров и рекламы.

Важно: ytfzf не использует официальный YouTube API. Он опирается на публичные Invidious-инстансы — их доступность может меняться.

Что такое ytfzf?

ytfzf получает список «здоровых» (работающих) Invidious-инстансов и выбирает один случайным образом. Через этот фронтенд оно выполняет поиск по YouTube-данным без прямого обращения к YouTube. Затем ytfzf передаёт ссылку в yt-dlp, а тот — в mpv для воспроизведения.

Коротко о компонентах:

• Invidious — альтернативный веб-фронтенд для YouTube, у которого много публичных инстансов.
• yt-dlp — инструмент для загрузки видео и извлечения потоков.
• mpv — лёгкий медиапроигрыватель для терминала.

Преимущества такого подхода: отсутствие рекламы и предроллов, отсутствие установки cookie от YouTube и возможность полностью терминального рабочего процесса.

Как установить ytfzf на Linux

Подготовьте зависимости. На Debian/Ubuntu-подобных дистрибутивах достаточно выполнить:

sudo apt install jq curl mpv fzf

Установите также yt-dlp — он нужен для получения потоков и загрузок. На многих дистрибутивах есть пакет yt-dlp, или можно установить через pip или релиз с GitHub.

Клонируйте репозиторий и перейдите в папку проекта:

git clone https://github.com/pystardust/ytfzf
cd ytfzf

Скомпилируйте и установите ytfzf, документацию и дополнения:

sudo make install
sudo make install doc
sudo make addons

Запустите ytfzf командой:

ytfzf

Подсказка: если команда тяжело запоминается, создайте алиас в своём shell-конфиге, например:

# Добавьте в ~/.bashrc или ~/.zshrc
alias ytf='ytfzf'

Как пользоваться ytfzf: быстрый гайд

Когда вы запускаете ytfzf, сначала программа получает список доступных Invidious-инстансов — это может занять пару секунд. Затем появится приглашение поиска.

• Введите ключевые слова (точность не обязательна). Например, “swif” быстро найдёт ролики Taylor Swift.
• Навигация: стрелки вверх/вниз и Enter для выбора.
• Воспроизведение: mpv откроется автоматически. Пауза — пробел, перемотка — стрелки.

Если хотите видеть превью/миниатюры, запустите с опцией:

ytfzf -t

Примечание: показ миниатюр зависит от возможностей конкретного терминала и может не работать в тонких консольах.

Чтобы создать плейлист, нажмите Tab на нужных видео, затем Enter — mpv начнёт последовательное воспроизведение.

Вместо интерактивного запуска можно передать запрос как аргумент:

ytfzf linux

Ниже перечислены полезные опции (частые сценарии):

1. -d — скачать выбранное видео через yt-dlp (вместо стрима в mpv)
2. -m — воспроизводить только аудио
3. -l — вернуть меню после остановки видео
4. -L — показать прямую ссылку на выбранное видео(ы)
5. -a — автоматически выбрать первый результат
6. -r — выбрать случайное видео

Пример: команда

ytfzf -a taylor bejeweled

немедленно запустит mpv и начнёт воспроизведение «Bejeweled» Taylor Swift (если первый результат соответствует запросу).

Мини-методология: что происходит под капотом

1. ytfzf запрашивает список доступных Invidious-инстансов.
2. Выбирается рабочая инстанс и выполняется поиск по запросу через Invidious API.
3. ytfzf показывает результаты в интерактивном списке (fzf-подобный интерфейс).
4. При выборе видео ytfzf передаёт URL в yt-dlp.
5. yt-dlp получает поток и/или метаданные, затем отдаёт их mpv для воспроизведения.

Такой поток позволяет обойти необходимость браузера и блокирует рекламные интеграции, которые обычно вставляет официальный сайт.

Когда это не сработает и альтернативы

Когда ytfzf может подвести:

• Все публичные Invidious-инстансы недоступны или заблокированы в вашей сети.
• Видео удалено или скрыто за региональными ограничениями.
• Терминал не поддерживает показ миниатюр или рендеринг нужных символов.

Альтернативы и дополнения:

• nmtui/tty-player + youtube-dl/yt-dlp — более ручной подход для скачивания и воспроизведения.
• Инструменты с GUI-фронтендом (например, браузерные расширения) — если вам нужен просмотр с субтитрами или комментариями.
• mpv + скрипты для автоматического поиска видео по URL.

Чек-лист по ролям

Для конечного пользователя (обычный юзер):

• Установить mpv и yt-dlp.
• Установить ytfzf и проверить запуск.
• Создать алиас для удобства.

Для администратора (на сервере/вдоль инфраструктуры):

• Убедиться, что Invidious-инстансы доступны из сети.
• Разрешить исходящие HTTPS-запросы к публичным инстансам.
• Настроить системные обновления yt-dlp и mpv.

Для разработчика/модератора:

• Проверять работу дополнений (addons) и совместимость с новыми версиями mpv.
• Логировать ошибки вызовов Invidious/yt-dlp для отладки.

Безопасность и приватность

• ytfzf не отправляет запросы напрямую в YouTube, поэтому YouTube не ставит cookie через этот путь.
• Тем не менее, ваш IP всё ещё видим Invidious-инстансу и конечным серверам, если вы не используете VPN или прокси.
• Будьте осторожны с публичными инстансами: не отправляйте чувствительные запросы, если не доверяете сервису.

Критерии приёмки

Чтобы считать установку и настройку завершённой, проверьте:

• ytfzf запускается без ошибок и отображает список инстансов.
• Воспроизведение видео в mpv происходит корректно для аудио и видео.
• Опции -d, -m, -a и -r работают как ожидается.
• Альянс (alias) работает в новой сессии shell после перезагрузки конфигурации.

Отладка и типичные ошибки

• Если ytfzf пишет “Fetching list of healthy invidious instances” и зависает — проверьте сетевой доступ и DNS.
• Если mpv не воспроизводит поток — проверьте наличие нужных кодеков и обновите yt-dlp.
• Ошибки при make install — убедитесь, что у вас есть права sudo и что зависимости установлены.

Краткое объявление (для рассылки или блога)

ytfzf — это простой способ смотреть YouTube, не открывая браузер: ищите видео в терминале, стримьте через mpv и избегайте рекламы и cookie. Удобно для тех, кто работает в терминале и хочет минимизировать отвлечения. Установка занимает несколько шагов: установить mpv и yt-dlp, клонировать репозиторий ytfzf и выполнить make install.

Краткий глоссарий (1 строка)

Invidious — альтернативный фронтенд для YouTube; yt-dlp — форк youtube-dl для скачивания потоков; mpv — консольный медиаплеер.

Резюме

• ytfzf даёт терминальный интерфейс для поиска и воспроизведения YouTube-видео через Invidious, yt-dlp и mpv.
• Установка требует mpv, yt-dlp и нескольких утилит (jq, curl, fzf).
• Инструмент уменьшает трекинг и рекламу, но зависит от доступности публичных Invidious-инстансов.

Эксперт: “Терминальный рабочий процесс с ytfzf помогает сосредоточиться и уменьшает количество отвлекающих элементов при просмотре видео.”