Telegram Media Server

Telegram Media Server is a Telegram bot that accepts links to streaming videos or torrent files, downloads them and distributes them on the internal network via a DLNA server (for example, minidlna).

Contents

• Features
• Requirements
• Installation
  • Installing the bot
  • Installing and setting up minidlna
• Configuration
• Usage
  • Available commands

Features

• Receiving links: Supports all video links supported by the yt-dlp utility.
• Content Download: Downloads videos and torrent files, tracking download progress.
• Distribution in internal network: Distributes downloaded content via DLNA server.
• Download Management: Allows you to view and manage current downloads via bot commands.
• User Authorization: Access to the bot is password protected.

Requirements

• Operating system: Arch Linux
• Architectures: aarch64, armv7h, x86_64
• Dependencies:
• For building: go
• For running: yt-dlp, minidlna (recommended)
• Other:
• Installed and configured DLNA server (e.g. minidlna)

Installation

Installing the bot

1. Installing the package:

Install the telegram-media-server package using the pacman package manager:

sudo pacman -U telegram-media-server.pkg.tar.zst

2. Configuration:

During installation, the sample configuration file will be copied to /etc/telegram-media-server/.env. If the configuration file is not created automatically, copy it manually:

sudo cp /etc/telegram-media-server/.env.example /etc/telegram-media-server/.env

3. Editing the configuration:

Open the /etc/telegram-media-server/.env file and configure the parameters according to your requirements.

4. Starting the service:

The telegram-media-server service should automatically be enabled and started. If this does not happen, run:

sudo systemctl enable telegram-media-server
sudo systemctl start telegram-media-server

Installing and configuring minidlna

1. Installing minidlna:

sudo pacman -Sy minidlna

2. Configuring minidlna:

Edit the configuration file /etc/minidlna.conf and configure the following parameters:

media_dir=V,/path/to/dir
friendly_name=My DLNA Server

Replace /path/to/dir with the same path specified in the MOVIE_PATH parameter of the bot's .env file.

3. Starting minidlna:

sudo systemctl enable minidlna
sudo systemctl start minidlna

Configuration

The bot configuration file is located at /etc/telegram-media-server/.env. Available parameters are described below:

• BOT_TOKEN (required): Your Telegram bot token received from BotFather.

• MOVIE_PATH: Path to the directory where the database, downloaded files and movies will be stored.

• PASSWORD: Password for authorizing users in the bot. Login is performed once for each chat.

• UPDATE_INTERVAL_SECONDS: Interval in seconds for sending updates on download progress (default: 30).

• UPDATE_PERCENTAGE_STEP: Download progress step in percent for sending updates (default: 20).

• MIN_DOWNLOAD_PERCENTAGE: Minimum download percentage of a torrent to continue downloading (default: 10).

• MAX_WAIT_TIME_MINUTES: Maximum time in minutes to wait for the minimum download percentage of a torrent (default: 10).

• LANG: Bot message language. Supported values: ru, en.

Example of .env file:

BOT_TOKEN=123456789:ABCDEFghIJKlmnoPQRStuvWXyz
MOVIE_PATH=/media/videos
PASSWORD=MySecretPassword
UPDATE_INTERVAL_SECONDS=30
UPDATE_PERCENTAGE_STEP=20
MIN_DOWNLOAD_PERCENTAGE=10
MAX_WAIT_TIME_MINUTES=10
LANG=en

Usage

Authorization

Before using the bot, you must log in using the command:

/login <password>

Where is the password specified in the PASSWORD parameter of the .env file.

Available commands

• /start — Displays a welcome message.
• /login — User authorization in the bot.
• /ls — Shows a list of current downloads and their status.
• /rm <id> — Deletes a download by ID obtained from the /ls command. Example: /rm 2.
• /rm all — Deletes all current downloads.
• /stop — Stops all current torrent downloads.

Sending links

After authorization, you can send the bot links to videos or torrent files. The bot supports all links that are processed by the yt-dlp utility.

Examples of supported links:

• YouTube
• VK
• RuTube
• and others

Slow downloads:

If the torrent file does not download to the minimum percentage (MIN_DOWNLOAD_PERCENTAGE) within the maximum waiting time (MAX_WAIT_TIME_MINUTES), the download will be automatically stopped and deleted.

RU Documentation

Telegram Media Server — это Telegram-бот, который принимает ссылки на стриминговое видео или торрент-файлы, загружает их и раздает во внутренней сети через DLNA-сервер (например, minidlna).

Оглавление

• Особенности
• Требования
• Установка
  • Установка бота
  • Установка и настройка minidlna
• Конфигурация
• Использование
  • Доступные команды

Особенности

• Прием ссылок: Поддерживает все ссылки на видео, которые поддерживаются утилитой yt-dlp.
• Загрузка контента: Загружает видео и торрент-файлы, отслеживая прогресс загрузки.
• Раздача во внутренней сети: Раздает загруженный контент через DLNA-сервер.
• Управление загрузками: Позволяет просматривать и управлять текущими загрузками через команды бота.
• Авторизация пользователей: Доступ к боту защищен паролем.

Требования

• Операционная система: Arch Linux
• Архитектуры: aarch64, armv7h, x86_64
• Зависимости:
  • Для сборки: go
  • Для выполнения: yt-dlp, minidlna (рекомендуется)
• Прочее:
  • Установленный и настроенный DLNA-сервер (например, minidlna)

Установка

Установка бота

1. Установка пакетa:

Установите пакет telegram-media-server с помощью пакетного менеджера pacman:

sudo pacman -U telegram-media-server.pkg.tar.zst

2. Конфигурация:

При установке файл примера конфигурации будет скопирован в /etc/telegram-media-server/.env. Если файл конфигурации не создан автоматически, скопируйте его вручную:

sudo cp /etc/telegram-media-server/.env.example /etc/telegram-media-server/.env

3. Редактирование конфигурации:

Откройте файл /etc/telegram-media-server/.env и настройте параметры в соответствии с вашими требованиями.

4. Запуск сервиса:

Сервис telegram-media-server должен автоматически включиться и запуститься. Если этого не произошло, выполните:

sudo systemctl enable telegram-media-server
sudo systemctl start telegram-media-server

Установка и настройка minidlna

1. Установка minidlna:

sudo pacman -Sy minidlna

2. Настройка minidlna:

Отредактируйте файл конфигурации /etc/minidlna.conf и настройте следующие параметры:

media_dir=V,/path/to/dir
friendly_name=My DLNA Server

Замените /path/to/dir на тот же путь, что указан в параметре MOVIE_PATH файла .env бота.

3. Запуск minidlna:

sudo systemctl enable minidlna
sudo systemctl start minidlna

Конфигурация

Файл конфигурации бота находится по пути /etc/telegram-media-server/.env. Ниже описаны доступные параметры:

• BOT_TOKEN (обязательно): Токен вашего Telegram-бота, полученный от BotFather.
• MOVIE_PATH: Путь к директории, где будут храниться база данных, загружаемые файлы и фильмы.
• PASSWORD: Пароль для авторизации пользователей в боте. Вход выполняется один раз для каждого чата.
• UPDATE_INTERVAL_SECONDS: Интервал в секундах для отправки обновлений о прогрессе загрузки (по умолчанию: 30).
• UPDATE_PERCENTAGE_STEP: Шаг прогресса загрузки в процентах для отправки обновлений (по умолчанию: 20).
• MIN_DOWNLOAD_PERCENTAGE: Минимальный процент загрузки торрента для продолжения загрузки (по умолчанию: 10).
• MAX_WAIT_TIME_MINUTES: Максимальное время в минутах ожидания загрузки минимального процента торрента (по умолчанию: 10).
• LANG: Язык сообщений бота. Поддерживаемые значения: ru, en.

Пример файла .env:

BOT_TOKEN=123456789:ABCDEFghIJKlmnoPQRStuvWXyz
MOVIE_PATH=/media/videos
PASSWORD=MySecretPassword
UPDATE_INTERVAL_SECONDS=30
UPDATE_PERCENTAGE_STEP=20
MIN_DOWNLOAD_PERCENTAGE=10
MAX_WAIT_TIME_MINUTES=10
LANG=en

Использование

Авторизация

Перед использованием бота необходимо авторизоваться с помощью команды:

/login <password>

Где — пароль, указанный в параметре PASSWORD файла .env.

Доступные команды

• /start — Отображает приветственное сообщение.
• /login — Авторизация пользователя в боте.
• /ls — Показывает список текущих загрузок и их статус.
• /rm <id> — Удаляет загрузку по ID, полученному из команды /ls. Пример: /rm 2.
• /rm all — Удаляет все текущие загрузки.
• /stop — Останавливает все текущие торрент-загрузки.

Отправка ссылок

После авторизации вы можете отправлять боту ссылки на видео или торрент-файлы. Бот поддерживает все ссылки, которые обрабатываются утилитой yt-dlp.

Примеры поддерживаемых ссылок:

• YouTube
• VK
• RuTube
• и другие

Медленные загрузки:

Если торрент-файл не загрузится на минимальный процент (MIN_DOWNLOAD_PERCENTAGE) в течение максимального времени ожидания (MAX_WAIT_TIME_MINUTES), загрузка будет автоматически остановлена и удалена.