# iyear/tdl

📥 A Telegram toolkit written in Golang

Repository: https://github.com/iyear/tdl
Canonical: https://ross.abutalabs.com/products/tdl
Homepage: https://docs.iyear.me/tdl
Language: Go
License: AGPL-3.0
License Family: copyleft
Topics: telegram, downloader, telegram-api, download, bash, telegram-bot, telegram-userbot, telegram-bots, telegram-channel
Last push: 2026-08-26T17:41:47+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 1463, "days_push": 7, "days_rel": 10, "gap_med": 24, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7980, forks 796 (observed 2026-08-28T04:10:10.503556+00:00)

## What it is
tdl is a fast, single-binary Telegram toolkit written in Go that downloads and uploads files, forwards messages, and exports chat data to JSON. It works with user accounts or bots, including protected chats, and is available via package managers and Docker.

## Use cases
- download files from telegram channels
- bulk download media from a telegram chat
- upload files to telegram from the command line
- export telegram messages and members to json
- download from protected telegram chats
- forward telegram messages with routing

## When to choose
- you need faster-than-official-client download speeds with low resource usage
- you want a single self-contained binary or Docker image with no runtime dependencies
- you need scripted, headless Telegram file transfer and data export

## When to avoid
- you need an interactive full Telegram GUI client
- you want a library to embed Telegram client logic into your own Go application
- your use case requires features outside downloading, uploading, forwarding, and exporting

## Facets
- artifact type: cli-tool
- maturity: active
- function: http-client, file-upload, developer-tools, cli
- domain: messaging-platforms, files
- platform: windows, cli, cross-platform, go
- tags: telegram, downloader, uploader, userbot, media-download, message-export, automation, command-line, linux, macos, docker

## Member repositories
- iyear/tdl (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:10.503556+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:32:35.105451+00:00, confidence not recorded.
  - readme: https://github.com/iyear/tdl (fetched 2026-08-28T04:10:10.503556+00:00, sha facae01942a7)
  - homepage: https://docs.iyear.me/tdl (fetched 2026-08-29T08:29:38.340830+00:00, sha 786b00c4fa8a)
  - site_page: https://docs.iyear.me/tdl/getting-started/installation (fetched 2026-08-29T08:29:38.356325+00:00, sha b914318f5474)
  - site_page: https://docs.iyear.me/tdl/getting-started/quick-start (fetched 2026-08-29T08:29:38.358595+00:00, sha f53017d95f70)
  - site_page: https://docs.iyear.me/tdl/getting-started/shell-completion (fetched 2026-08-29T08:29:38.360328+00:00, sha 82f100c4cdeb)
- Data as of 2026-08-30T08:39:29.467469+00:00.