Skip to main content

A simple CLI tool to download videos from Telegram channels

Project description

teledown

teledown is a simple CLI tool for internal use to download videos from Telegram (public/private) channels.

Features

  • List all channels
  • Search for channels by name
  • Count total videos in a specified channel
  • Download videos from a specified channel
  • Send a message to yourself

Installation

(Add installation instructions here, including any dependencies)

Usage

python __main__.py [COMMAND] [OPTIONS] [ARGUMENTS]

Available Commands

  1. message: Send a message to yourself

    python __main__.py message "Your message here"
    
  2. lists: List all channels

    python __main__.py lists
    
  3. search: Search for a channel by name

    python __main__.py search "channel name"
    
  4. count: Count total videos in the specified channel

    python __main__.py count CHANNEL_ID [--sort asc|desc]
    
  5. download: Download videos from the specified channel

    python __main__.py download CHANNEL_ID [OPTIONS]
    

    Options:

    • --limit INTEGER: Limit the number of videos to download (0 for no limit)
    • --output-dir PATH: Directory to save downloaded videos (default: 'downloads')
    • --resume: Resume the download from where it stopped
    • --post-ids TEXT: Comma-separated list of specific post IDs to download

Configuration

Before using the tool, make sure to set up your Telegram API credentials in the script:

api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

Examples

  1. List all channels:

    python __main__.py lists
    
  2. Search for a channel:

    python __main__.py search "news channel"
    
  3. Count videos in a channel:

    python __main__.py count 1234567890 --sort desc
    
  4. Download videos from a channel:

    python __main__.py download 1234567890 --limit 10 --output-dir "my_videos" --resume
    
  5. Download specific posts from a channel:

    python __main__.py download 1234567890 --post-ids "123,456,789"
    

Note

This tool is for internal use only. Make sure you have the necessary permissions to access and download content from the Telegram channels you're interacting with.

License

(Add license information here)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

teledown-0.1.2.tar.gz (4.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

teledown-0.1.2-py3-none-any.whl (4.7 kB view details)

Uploaded Python 3

File details

Details for the file teledown-0.1.2.tar.gz.

File metadata

  • Download URL: teledown-0.1.2.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.2

File hashes

Hashes for teledown-0.1.2.tar.gz
Algorithm Hash digest
SHA256 bba25e531597c2c14868ccb227fcb38be305ef72b1d4b1f6f603f5a9175a3ad5
MD5 81c853b012d8bfb305206f8a62b2e5dc
BLAKE2b-256 8d822125a4e4ad4c6d4deb64f2cf59769b5af00e35c542ffb12d6a3082d0684f

See more details on using hashes here.

File details

Details for the file teledown-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: teledown-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 4.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.2

File hashes

Hashes for teledown-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 bb4277894cfb39d31b13e40d6ae306bcdf78a2079c67286f6e9476628bd72155
MD5 76bbaa19683a8ae638363e5baed68c4e
BLAKE2b-256 8c70033f46b3426feac98faece063d15dae9c04b2598a45ce55d3118c53f0523

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page