Telegram Downloader - User Manual

Version: 1.2

Last Updated: December 5, 2025

---

Table of Contents

  • Quick Start
  • Message Download
  • Channel Download
  • Configuration Management
  • Language Switching
  • Theme Management
  • Advanced Features
  • Help Center
  • FAQ

    • ---

    Quick Start

    Main Interface

  • Message Download: Download single or multiple messages
  • Configuration Guide: First-time setup or modify settings
  • Tab Switching: Switch between message download and channel download
  • Configuration Area: View and modify settings, manage proxies, manage download settings
  • Status Bar: Shows current login status
  • Top Configuration: Quick switch language and theme

    • Supported Features Highlights

    Comprehensive Chat Type Support (v2.0.0.6.1)

    • ✅ Channel message download
    • ✅ Supergroup message download
    • ✅ Regular group message download
    • ✅ Private chat message download
    • ✅ Bot conversation message download

    All chat types can be accessed and downloaded through the "Channel Download" tab, achieving complete Telegram message download coverage.

    Main Button Description

    Download assistant main functions fall into these categories:

    • Left Side: Configuration, themes, advanced features, help
    • Middle Section: Message download, channel download
    • Right Side: Actual download task management and execution status

    ---

    Message Download

    Message download is used to download files from single or multiple Telegram messages.

    Supported Chat Types (v2.0.0.6.1 Update)

    This program supports file downloads from all Telegram chat types:

    Chat TypePublic LinkInternal LinkDownload MethodNotes
    Channel✅ https://-New Download DialogCan share public link with everyone
    Supergroup✅ https://-New Download DialogCan share public link with everyone
    Regular Group❌ None✅ msg://New Download DialogCan copy internal link (only for this program)
    Private Chat❌ None✅ msg://New Download DialogCan copy internal link (only for this program)
    Bot❌ None✅ msg://New Download DialogCan copy internal link (only for this program)
    Link Type Explanation:
    • Public Link (https://t.me/...):

    - Can be opened in Telegram

    - Can be shared with anyone

    - Applicable to channels and supergroups

    • Internal Link (msg://{chat_id}/{message_id}):

    - Only used in this program

    - Cannot be opened in Telegram

    - Can copy, save, paste into "New Download" dialog

    - Can share with other users of this program

    - Applicable to regular groups, private chats, bots

    Usage:

  • All message types support clicking download button to open "New Download" dialog
  • All link types can be copied and pasted
  • Link format is automatically recognized, no manual mode selection needed

    • Create Download Task

  • Click "New Download" button
  • Enter message link:

    • - Can enter single link or multiple links

    - One link per line or separated by commas

    - Example: https://t.me/channel_name/123

  • Configure rename rules (optional):

    • - Author Name: Add author name to filename

    - Timestamp: Add download timestamp to filename

    - Custom Info: Add custom text to filename

    - Keep Original Filename: Preserve original filename

    - Download Comment Media: Download all files from message comments

  • Filename Format:

    • - Full format: Author_Timestamp_CustomInfo_OriginalFilename

    - Example: John_20251204_120000_MeetingVideo.mp4

    - Comment format: OriginalFilename_comments

  • Download Comments Settings:

    • - When checked, will download all media files from message comments

    - Comment files saved in OriginalFilename_comments folder

  • Force Deduplication:

    • - When checked, detects duplicate media files (based on file unique ID and hash)

    - If duplicate found, will not download

    - Shows location of already downloaded file

  • Preview: Preview final generated filename format
  • Click "OK": Add download task to download list

    • Manage Download Tasks

    Task Status

    Download tasks have the following states:

    • Waiting: Task added, waiting to download
    • Downloading: Task is executing download
    • Paused: Task paused by user
    • Completed: Download finished
    • Failed: Error occurred during download
    • Canceled: Task canceled by user

    Batch Operations

    • Select All: Select all download tasks in current tab
    • Pause Download: Pause selected downloading tasks
    • Start Download: Resume all paused download tasks
    • Delete Selected: Delete selected tasks (will clean up downloaded files)
    • Clear Current Status: Delete all tasks in current tab

    View Download Details

    Download task table shows the following information:

    • No.: Task number
    • Link: Telegram message link
    • Filename: Filename after download
    • Size: File size
    • Progress: Download progress bar (shows percentage)
    • Status: Current task status
    • Created: Task creation time
    • Actions: Operations for current task

    Usage Tips

    • Download status depends on network environment and Telegram server status
    • If too many download tasks, recommend downloading in batches (1-3 with default credentials, 1-5 with own credentials)
    • For many download tasks, recommend enabling multiple concurrent links
    • If download fails, can restart download

    ---

    Channel Download

    Channel download is used to batch download message files from Telegram channels.

    Load Channels

  • Member Category: Member category on left side of downloader
  • Refresh Channels: Click "Refresh Channels" button to load category download channel list
  • Search Channels: Enter keywords in search box to search channels
  • Select Channel: Select single channel from channel list

    • Note: Channel list includes all chat types:

    • Channels and supergroups (with public links)
    • Regular groups (no public links)
    • Private chats (no public links)
    • Bot conversations (no public links)

    Download Regular Group/Private Chat Messages (v2.0.0.6 New)

    For chats without public links (regular groups, private chats, bots), download process:

  • Select Chat

    • - Select regular group, private chat or bot from channel list

    - These chats display same as channels in list

  • View Messages

    • - Click "Filter" to set filter criteria (optional)

    - Message list will show messages matching criteria

  • Download Files

    • - Single Download: Click "Download" button on message row

    - Batch Download: Select multiple messages then click "Download Selected"

    - Program automatically recognizes these are linkless messages, directly adds to download queue

  • Notes

    • - These messages cannot copy links (clicking "Copy Link" will show prompt)

    - Download process same as messages with links

    - Supports all download options (rename, comments, deduplication, etc.)

    Filter Messages

    Click "Filter" button to open filter criteria popup:

    Filter Criteria

  • Keyword: Search for messages containing specific keywords
  • File Type: Can select

    • - Video: All video formats (mp4, avi, mkv, etc.)

    - Audio: All audio formats (mp3, wav, flac, etc.)

    - Images: All image formats (jpg, png, gif, etc.)

    - Documents/Books: Office documents, PDF, txt, ebooks, etc.

    - Other Files: Other file types besides above

  • Date Range:

    • - Enable Start Date: Set message start date

    - Enable End Date: Set message end date

  • File Size: Set file size range (minimum-maximum, in MB)

    • Filter Operations

    • Apply Filter: Load messages matching criteria to message table
    • Clear: Restore default filter criteria
    • Cancel: Close filter criteria popup

    View Messages

    After filtering, message table displays:

    • Thumbnail: Click to view if thumbnail available
    • Filename: Display filename
    • Message Text: Click to view message details

    - Can copy all content, copy filename, copy description and close operations

    • Size: File size in message
    • Date: Message publish date
    • Actions:

    - Download: Download message file

    - Copy Link: Copy message link to clipboard

    Batch Download

    Download Filter Results

    Click "Download Filter Results" button to batch download all filtered messages:

  • View Filter Criteria: Confirm current filter criteria
  • Configure Download Rules:

    • - Rename rules (like message download)

    - Whether to download comments

    - Whether to force deduplication

  • Click Start Fetch and Download: Add all filtered messages to message download table per settings

    • Download Selected Messages

  • Select All: Click "Select All" button to select all rows in current message table
  • Manual Select: Select message rows to download from message table
  • Click "Download Selected": Open new download popup
  • Configure Rules: Set rename, comments, deduplication rules
  • Confirm: Add to download task list

    • Manage Permissions

    • Member/Non-Member: Switch message pages
    • Refresh Current Page: Reload current page messages
    • Filter criteria will display after filter button

    ---

    Configuration Management

    Open Configuration

    Click "Configuration" or "Configuration Guide" in left menu to open configuration popup.

    Configuration Items

    Language and Theme

    • Member language and theme (Simplified Chinese, Traditional Chinese, English)
    • Takes effect immediately after switching

    Basic Configuration

    • Actual download path:
    • Will guide on first use

    Network Environment Detection

    • Click "Detect Network Environment" button
    • Can import detection results to proxy configuration

    Phone Number Configuration

    • Bind Telegram account phone number
    • Format: +1 555XXXXXXXX
    • Will prompt whether login needed

    API Configuration

    Use Default Credentials (Recommended)

    • Use API configuration provided by assistant
    • Simple and easy, no configuration needed
    • Download speed: 1-3 parallel tasks

    Use Own API Credentials

    • Visit and login to Telegram API
    • Get API ID and API Hash
    • Download speed: 1-5 parallel tasks
    • Notes: "Apply for Telegram API" in left menu "Help"

    Proxy Configuration

    Import System Proxy

    • Automatically detect system proxy configuration
    • One-click import, no manual input needed

    Proxy Type

    • SOCKS5: Recommended, good compatibility
    • HTTP: Proxy management requirements

    Proxy Parameters

    • Proxy Address: Proxy server IP address
    • Proxy Port: Proxy server port
    • Username: If proxy requires authentication
    • Password: If proxy requires authentication

    Test Proxy

    • Click "Test Proxy" button
    • Can test if current proxy configuration can connect to Telegram
    • Actual test connection result will display below test button

    Network Diagnostics

    • Comprehensive network environment check
    • Diagnose if can normally connect to Telegram
    • Provide repair suggestions

    Download Configuration

    Save Path

    • Set file download save configuration
    • Default: System downloads folder
    • Click "Browse" button to select other folder

    Maximum Concurrent Downloads

    • Using default credentials: 1-3
    • Using own credentials: 1-5
    • Higher number means recommended faster download status, but may cause single task slower downloads

    Member Benefits

    Configuration popup shows member benefits information at end:

    • Channel Download: Members can use this feature
    • Increase Concurrent Downloads: Members can increase credential concurrency
    • Priority Support: Members enjoy priority support

    Click "Upgrade to Member Now" to open member upgrade popup.

    ---

    Language Switching

    Switch Language

  • Click "Language" in left menu
  • Members can switch language:

    • - Simplified Chinese

    - Traditional Chinese

    - English

  • Language takes effect immediately

    • Support Scope

    Language switching affects:

    • All interface text
    • Member menus
    • Button messages
    • Dialog messages
    • Help documentation

    ---

    Theme Management

    Switch Theme

  • Click "Theme" in left menu
  • Members can select theme
  • Takes effect immediately

    • Theme Types

    Theme switching affects:

    • Main window color scheme
    • Member button colors
    • Progress bar colors
    • Table colors
    • All control theme colors

    Customization

    Members can create custom themes, change assistant colors.

    ---

    Advanced Features

    User Info

    Click "Advanced" in left menu then "User Info" to view:

    Non-Member Users

    • Actual current user ID
    • Show speed and limits
    • Guide to upgrade membership:
    • Upgrade to Member Now: Open member guide popup
    • Refresh: Reload user info

    Member Users

    • Actual member info
    • Member expiration time
    • List of enjoyed permissions
    • Upgrade to Member Now: Extend membership duration
    • Refresh: Update member info

    Member Guide

    In member guide popup:

  • View member privilege list description
  • Member purchase or selection
  • Complete payment
  • Auto-refresh user info after closing

    • ---

    Help Center

    User Guide

    Click "Help" in left menu then "User Guide":

    • Opens online instructions
    • Address: https://www.tgload.com/guide
    • Contains detailed tutorials and video demonstrations

    Apply for Telegram API

    Click "Help" in left menu then "Apply for Telegram API":

    • Opens API application page
    • Member registration process and complete application
    • Get API ID and API Hash

    About

    Click "Help" in left menu then "About":

    • View software version number
    • Technical support contact information
    • Official website address

    ---

    FAQ

    Q1: Download speed is very slow, what to do?

    Answer:

  • Check if network connection is normal
  • Check proxy settings, try changing proxy server
  • Reduce concurrent download count
  • Try using VPN connection

    • Q2: Cannot connect to Telegram, what to do?

    Answer:

  • Check if network can normally connect to Telegram
  • Check configuration, configure proxy server
  • Use "Network Diagnostics" feature to check
  • Try using VPN

    • Q3: Download task failed, what to do?

    Answer:

  • View failure error message
  • Check if message link is valid
  • Confirm if have permission to access message
  • Try re-logging in
  • Contact technical support

    • Q4: How to delete downloaded files?

    Answer:

  • In Telegram refresh and open original message
  • Use system file explorer to find save location
  • Member "Copy Message Link"
  • Manually delete in folder

    • Q5: How to see possible download duration?

    Answer:

    • Using default credentials: 1-3
    • Using own API credentials: 1-5
    • Specific duration depends on configuration and credentials

    Q6: How to set rename rules?

    Answer:

  • When adding download task, member "Author Name"
  • Enter author, keep original filename and other options
  • Member "Custom Info" adds custom text to filename
  • Member "Download Comment Media" downloads comment files
  • Click confirm to apply naming format per settings

    • Q7: What does download comments mean?

    Answer:

    • If message has comments (discussion group), when checked will download all images, videos and other files from comments
    • Comment files saved in OriginalFilename_comments folder
    • Simple download member processes comments separately

    Q8: How does force deduplication work?

    Answer:

    • Based on file's Telegram internal unique identifier (file ID and hash) to detect duplicates
    • After closing download progress, if found already downloaded will skip this download
    • If duplicate found, shows file already downloaded location
    • Shows existing location source

    Q9: Is channel download for members only?

    Answer:

    • Yes, channel download is member-exclusive feature
    • Non-members clicking channel download will be guided to upgrade membership
    • Message download feature is open to all users

    Q10: How to view download logs?

    Answer:

    • Download logs saved in download assistant root directory cache folder
    • Database file: telegram_downloader.db
    • Log copy will clear viewing records
    • If encountering problems, copying logs can help us better diagnose issues

    Q11: Why can't some messages copy links? (v2.0.0.6 New)

    Answer:

    • Regular groups, private chats, bot messages don't have public links
    • Telegram only provides public links for channel and supergroup messages
    • These messages can be directly downloaded through "Channel Download" tab
    • Clicking "Download" button will automatically add to download queue, no need to copy link

    Q12: How to download regular group messages? (v2.0.0.6 New)

    Answer:

  • Open "Channel Download" tab
  • Select regular group from channel list
  • View and filter messages
  • Click "Download" button or "Download Selected"
  • Program will automatically recognize and download, no need to manually copy link

    • Q13: Can files from private chats and bots be downloaded? (v2.0.0.6 New)

    Answer:

    • Yes! v2.0.0.6 version started supporting all chat types
    • Select private chat or bot conversation in "Channel Download" tab
    • View message list, click download
    • Download process exactly same as channel messages

    ---

    Technical Support

    If encountering problems or have questions:

  • View download logs: cache/logs/app.log
  • Visit official website: https://td.gewu.dev
  • Contact technical support (get contact info in "About" page)
  • Submit user feedback to website

    • ---

    Version History

    v2.0.0.6 (December 5, 2025)

    • New: Support for messages without public links (regular groups, private chats, bots)
    • New: Dual-mode download architecture (link mode + message object mode)
    • Optimized: Copy link feature, filters invalid pseudo-links
    • Improved: Support for file downloads from all Telegram chat types

    v1.0 (December 4, 2025)

    • Initial version release
    • Message download feature
    • Channel download feature
    • Configuration management feature
    • Theme management
    • Member features

    ---

    Thank you for using Telegram Downloader!

    If you have any suggestions, please feel free to contact us.

    Need More Help?

    Quick Start GuideFAQTutorial Articles