# Installer telegram-downloader avec Homebrew, scoop, Nix

Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de telegram-downloader pour les workflows d'agents IA.

## installation

```sh
sudo av install brew:telegram-downloader
```

Commandes d'installation supplémentaires:

### macOS

- Homebrew (100%):

```sh
brew install telegram-downloader
```

  Preuve: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#tdl
```

  Preuve: nixpkgs package indexes: pkgs/by-name/td/tdl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install extras/telegram-downloader
```

  Preuve: Scoop official bucket manifest trees: bucket/telegram-downloader.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

## Faits du paquet

- **Clé du paquet:** brew:telegram-downloader
- **Gestionnaire de paquets:** Homebrew
- **Version:** 0.20.3
- **Résumé source:** Telegram Messenger downloader/tools written in Golang
- **Page d'accueil:** <https://docs.iyear.me/tdl/>
- **Dépôt:** <https://github.com/iyear/tdl>
- **Dernière mise à jour:** 2026-07-26T00:50:34+02:00
- **Généré:** 2026-08-03T19:37:03+00:00

## exécutables

- tdl (alias)

## Comportement d'installation

- Bouteille: non disponible

## Version et fraîcheur

- page générée: 2026-08-03
- version du gestionnaire: 0.20.3
## Historique du projet et usages

tdl, packaged by Homebrew as telegram-downloader, is a Go Telegram toolkit whose scope grew beyond downloading into forwarding, uploading, exporting, and migration tasks.

### Historique du projet

The iyear/tdl repository was created in 2022, with an early v0.1.0-beta release in September 2022. The official README and documentation describe it as 'Telegram Downloader, but more than a downloader' and as a Telegram toolkit written in Go.

The project developed around Telegram power-user workflows that official clients do not optimize for: bulk downloads, protected-chat handling, JSON exports, message forwarding, upload workflows, and session migration.

### Historique d'adoption

tdl's adoption is visible in its packaging spread across Homebrew, Scoop, Termux, AUR, Nix, Docker, and prebuilt release assets. The official installation docs list Homebrew's `brew install telegram-downloader` path alongside one-line scripts and binaries.

The GitHub repository has thousands of stars and many release artifacts, indicating a CLI niche larger than a one-off script but still centered on Telegram automation and archival users.

### Modes d'utilisation

Users run `tdl dl` to download from Telegram message links or exported JSON, `tdl chat export` to produce JSON for media downloads, `tdl forward` to forward or clone messages with routing rules, and related commands to upload files or export members.

For package nerds, the interesting part is that the packaged executable exposes a whole Telegram data workflow while keeping user state under `~/.tdl`, which makes upgrades and backup behavior straightforward.

### Pourquoi les passionnés de paquets s'y intéressent

telegram-downloader is notable as a package-manager-friendly wrapper around a service-specific power tool. It is the kind of CLI users want from Brew because it avoids manual GitHub asset selection and gives a stable `tdl` command on PATH.

The package also reflects a common modern packaging pattern: a Go single binary with cross-platform release assets, shell completions, Docker images, and docs that explicitly call out several package managers.

### Chronologie

- 2022: iyear/tdl repository created and v0.1.0-beta released.
- 2023: Documentation covers export and troubleshooting workflows for Telegram sessions.
- 2024: Download docs document protected-chat JSON export and resume/serve workflows.
- 2026: v0.20.3 is published in the official GitHub releases.

### Related projects

- Telegram Desktop is referenced in docs as a source of exported chat JSON.
- aria2, wget, axel, and IDM are adjacent download managers mentioned by tdl docs for serve-mode workflows.
- Other Telegram bot and userbot tools overlap, but tdl is packaged primarily as a terminal downloader/toolkit.

### Sources

- <https://docs.iyear.me/tdl/>
- <https://docs.iyear.me/tdl/getting-started/installation/>
- <https://docs.iyear.me/tdl/guide/download/>
- <https://docs.iyear.me/tdl/guide/forward/>
- <https://docs.iyear.me/tdl/guide/tools/export-messages/>
- <https://github.com/iyear/tdl>
- <https://github.com/iyear/tdl/releases/tag/v0.20.3>


## Notes de sécurité

broad file, network, media, or database tool signal.

- **Risque Geiger:** blue / moyen
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Credential files

- Unix: ~/.tdl
## Autres enregistrements de gestionnaires de paquets

- Scoop - extras/telegram-downloader: normalized package name match | Scoop official bucket manifest trees: bucket/telegram-downloader.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1
- Nix - tdl: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/td/tdl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/telegram-downloader.yml](https://github.com/mxcl/pkgdb/blob/main/combined/telegram-downloader.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph