# yt-dlp-telegram-bot

This bot downloads videos from various supported sources
(see [yt-dlp](https://github.com/yt-dlp/yt-dlp) and then re-uploads them
to Telegram, so they can be viewed with Telegram's built-in video player.

<p align="center"><img src="screenshot.png?raw=true"/></p>

The bot displays the progress and further information during processing by
responding to the message with the URL. Requests are queued, only one gets
processed at a time.

The bot uses the [Telegram MTProto API](https://github.com/gotd/td), which
supports larger video uploads than the default 50MB with the standard
Telegram bot API. Videos are not saved on disk, they are simultaneously
uploaded from the source to Telegram. Incompatible video and audio streams
are automatically converted to match those which are supported by Telegram's
built-in video player.

The only dependencies are [yt-dlp](https://github.com/yt-dlp/yt-dlp) and
[ffmpeg](https://github.com/FFmpeg/FFmpeg). Tested on Linux, but should be
able to run on other operating systems.

## Compiling

You'll need Go installed on your computer. Install a recent package of `golang`.
Then:

```
go get github.com/nonoo/yt-dlp-telegram-bot
go install github.com/nonoo/yt-dlp-telegram-bot
```

This will typically install `yt-dlp-telegram-bot` into `$HOME/go/bin`.

Or just enter `go build` in the cloned Git source repo directory.

## Prerequisites

1. Create a Telegram bot using [BotFather](https://t.me/BotFather) and get the
   bot's `token`.
2. [Get your Telegram API Keys](https://my.telegram.org/apps)
   (`api_id` and `api_hash`). You'll need to create an app if you haven't
   created one already. Description is optional, set the category to "other".
   If an error dialog pops up, then try creating the app using your phone's
   browser.
3. Make sure `yt-dlp`, `ffprobe` and `ffmpeg` commands are available on your
   system.

## Running

You can get the available command line arguments with `-h`.
Mandatory arguments are:

- `-api-id`: set this to your Telegram app `api_id`
- `-api-hash`: set this to your Telegram app `api_hash`
- `-bot-token`: set this to your Telegram bot's `token`

Set your Telegram user ID as an admin with the `-admin-user-ids` argument.
Admins will get a message when the bot starts and when a newer version of
`yt-dlp` is available (checked every 24 hours).

Other user/group IDs can be set with the `-allowed-user-ids` and
`-allowed-group-ids` arguments. IDs should be separated by commas.

You can get Telegram user IDs by writing a message to the bot and checking
the app's log, as it logs all incoming messages.

All command line arguments can be set through OS environment variables.
Note that using a command line argument overwrites a setting by the environment
variable. Available OS environment variables are:

- `API_ID`
- `API_HASH`
- `BOT_TOKEN`
- `YTDLP_PATH`
- `ALLOWED_USERIDS`
- `ADMIN_USERIDS`
- `ALLOWED_GROUPIDS`

## Supported commands

- `/dlp` - Download
- `/dlpcancel` - Cancel ongoing download

You don't need to enter the `/dlp` command if you send an URL to the bot using
a private chat.

## Contributors

- Norbert Varga [nonoo@nonoo.hu](mailto:nonoo@nonoo.hu)
- Akos Marton

## Donations

If you find this bot useful then [buy me a beer](https://paypal.me/ha2non). :)