53 lines
3.1 KiB
Markdown
53 lines
3.1 KiB
Markdown
# 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 из браузера, выбирать качество.** |