telegram-dl 1.0.0

Download videos from Telegram channels

Telegram Downloader

A Python CLI tool to download videos from Telegram channels.

Installation

pip install telegram-dl

Setup

1. Go to my.telegram.org
2. Log in and create an app
3. Copy your API ID and API Hash

Usage

List your channels

telegram-dl --api-id 12345 --api-hash abc123 --phone [phone] --list-channels

Download all videos from a channel

telegram-dl --api-id 12345 --api-hash abc123 --phone [phone] --channel -100123456789

Download to custom directory

telegram-dl --api-id 12345 --api-hash abc123 --phone [phone] --channel -100123456789 --output ./my_videos

Programmatic Usage

from telegram_dl import TelegramDownloader

async def main():
    async with TelegramDownloader(api_id, api_hash, phone) as dl:
        # List channels
        for dialog in dl.client.iter_dialogs():
            if dialog.is_channel:
                print(f"{dialog.id} | {dialog.title}")
        
        # Download all videos
        await dl.download_all_videos(channel_id, "./videos")

asyncio.run(main())

Features

• Download all videos from Telegram channels
• Automatic session management (login once, use many times)
• Progress tracking
• Named file preservation
• Skip already downloaded files

License

MIT