search

Nyaran / telegram-download-daemon-ng

A simple script to automate telegram download of big files
GNU General Public License v3.0
2 stars 0 forks source link

readme

telegram-download-daemon-ng

License: GPL v3 Test codecov

PyPI downloads Docker pulls

Ko-fi Buy me a coffee

A Telegram Daemon (not a bot) for file downloading automation for channels of which you have admin privileges.

Based on the original work of @alfem: https://github.com/alfem/telegram-download-daemon

If you have got an Internet connected computer or NAS and you want to automate file downloading from Telegram channels, this daemon is for you.

Telegram bots are limited to 20Mb file size downloads. So I wrote this agent or daemon to allow bigger downloads (limited to 2GB by Telegram APIs).

Installation

You need Python3.8 or above

Install dependencies by running this command:

pip install telegram-download-daemon-ng

Obtain your own api id: https://core.telegram.org/api/obtaining_api_id

Usage

You need to configure these values:

Environment Variable Command Line argument Description Default Value
TELEGRAM_DAEMON_API_ID --api-id api_id from https://core.telegram.org/api/obtaining_api_id
TELEGRAM_DAEMON_API_HASH --api-hash api_hash from https://core.telegram.org/api/obtaining_api_id
TELEGRAM_DAEMON_CHANNEL --channel Channel id to download from it (Please, check Issue 45, Issue 48 and Issue 73)
TELEGRAM_DAEMON_BOT --bot Bot identifier to use. If not present, it will be requested (or the phone number) on first start
TELEGRAM_DAEMON_SESSION_PATH Path with session files
TELEGRAM_DAEMON_DEST --dest Destination path for downloaded files /telegram-downloads
TELEGRAM_DAEMON_TEMP --temp Destination path for temporary (download in progress) files use --dest
TELEGRAM_DAEMON_DUPLICATES --duplicates What to do with duplicated files: ignore, overwrite or rename them rename

You can define them as Environment Variables, or put them as a command line arguments, for example:

python3 telegram_download_daemon.py --api-id <your-id> --api-hash <your-hash> --channel <channel-number>

Finally, resend any file link to the channel to start the downloading. This daemon can manage many downloads simultaneously.

You can also 'talk' to this daemon using your Telegram client:

Docker/Podman

If you are using Podman instead of Docker, just replace the docker word in the following commands by podman.

On a terminal run:

docker pull nyaran/telegram-download-daemon-ng

Then run it.

Replace values for TELEGRAM_DAEMON_API_ID, TELEGRAM_DAEMON_API_HASH and TELEGRAM_DAEMON_CHANNEL (see the table above), and set the paths for the volumes.

docker run \
 --rm \
 -e TELEGRAM_DAEMON_API_ID="YOUR_API_ID_HERE" \
 -e TELEGRAM_DAEMON_API_HASH="YOUR_API_HASH_HERE" \
 -e TELEGRAM_DAEMON_CHANNEL="YOUR_CHANNEL_ID_HERE" \
 -v "DOWNLOADS_VOLUME_PATH_HERE":/downloads \
 -v "SESSION_VOLUME_PATH_HERE":/session \
 -v "TEMP_VOLUME_PATH_HERE":/temp \
 --name telegram-download-daemon-ng \
 nyaran/telegram-download-daemon-ng

Note. The first time, you need to generate your session, to do that, and if you are not providing your bot ID, run the image in the interactive way, using -it (is important to use the same parameters)

docker run -it \
 --rm \
 -e TELEGRAM_DAEMON_API_ID="YOUR_API_ID_HERE" \
 -e TELEGRAM_DAEMON_API_HASH="YOUR_API_HASH_HERE" \
 -e TELEGRAM_DAEMON_CHANNEL="YOUR_CHANNEL_ID_HERE" \
 -v "DOWNLOADS_VOLUME_PATH_HERE":/downloads \
 -v "SESSION_VOLUME_PATH_HERE":/session \
 -v "TEMP_VOLUME_PATH_HERE":/temp \
 --name telegram-download-daemon-ng \
 nyaran/telegram-download-daemon-ng

Or just provide the bot ID (Replace "YOUR_BOT_ID" with the identifier of your bot):

docker run -it \
 --rm \
 -e TELEGRAM_DAEMON_API_ID="YOUR_API_ID_HERE" \
 -e TELEGRAM_DAEMON_API_HASH="YOUR_API_HASH_HERE" \
 -e TELEGRAM_DAEMON_CHANNEL="YOUR_CHANNEL_ID_HERE" \
 -e TELEGRAM_DAEMON_BOT="YOUR_BOT_ID" \
 -v "DOWNLOADS_VOLUME_PATH_HERE":/downloads \
 -v "SESSION_VOLUME_PATH_HERE":/session \
 -v "TEMP_VOLUME_PATH_HERE":/temp \
 --name telegram-download-daemon-ng \
 nyaran/telegram-download-daemon-ng