# 2026-matrix-down

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

Хотя этот проект в первую очередь стремится быть максимально удобным Matrix
ботом, не в последнюю очередь он существует ради того, чтобы с его помощью
тестировать библиотеку [`mab`](https://git.tyukalov.su/nikita/mab), а точнее
её возможности загрузки вложений в Matrix.

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

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

1. Соберите образ
```bash
sudo docker build -t 2026-matrix-down .
```
2. Выполните первый запуск в интерактивном режиме
```bash
sudo mkdir runtime
sudo chown 1000:1000 runtime
sudo docker run -v ./runtime:/runtime -ti 2026-matrix-down
```
3. В папке `runtime` появится файл `config.json`. Внесите туда нужные настройки
4. Запустите ещё раз в интерактивном режиме, чтобы авторизоваться
```bash
sudo docker run -v ./runtime:/runtime -ti 2026-matrix-down
```
5. Дальше можно запускать контейнер в фоне
```bash
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 из браузера, выбирать качество.**