2026-matrix-down/README.md

2026-matrix-down

Matrix бот для скачивания видео/аудио с YouTube, Pinterest, Instagram и других хостингов, поддерживаемых приложением yt-dlp.

Хотя этот проект в первую очередь стремится быть максимально удобным Matrix ботом, не в последнюю очередь он существует ради того, чтобы с его помощью тестировать библиотеку mab, а точнее её возможности загрузки вложений в Matrix.

В системе должны быть установлены ffmpeg, ffprobe и yt-dlp.

Для запуска рекомендуется docker

1. Соберите образ

sudo docker build -t 2026-matrix-down .

2. Выполните первый запуск в интерактивном режиме

sudo mkdir runtime
sudo chown 1000:1000 runtime
sudo docker run -v ./runtime:/runtime -ti 2026-matrix-down

3. В папке runtime появится файл config.json. Внесите туда нужные настройки
4. Запустите ещё раз в интерактивном режиме, чтобы авторизоваться

sudo docker run -v ./runtime:/runtime -ti 2026-matrix-down

5. Дальше можно запускать контейнер в фоне

sudo docker run-v ./runtime:/runtime --detach 2026-matrix-down

Рекомендуется запускать контейнер при помощи docker compose.

Работа с ботом

Первый запуск сгенерирует файл config.json в рабочей директории. Используйте его, чтобы ввести адрес сервера и имя пользователя. Затем при запуске бота авторизуйтесь интерактивно.

Бот должен быть добавлен в комнату, в которой с ним будут работать. Все сообщения в комнате бот обрабатывает, как адресованные лично ему.

• Если сообщение заканчивается на TesT (регистр и пробел в начале важен), то бот отправит медиафайлы из папки test_media
• Если сообщение начинается не с http:// или https://, то бот даст справку
• Если сообщение начинается с http:// или https://, то бот передаст текст сообщения в качестве ссылки yt-dlp, скачает видео в максимально возможном качестве, и отправит его в Matrix

Интерфейс планируется добработать, в том числе добавить возможность скачивать аудио, копировать cookies из браузера, выбирать качество.