Telegram Files

Telegram Files is a self-hosted Telegram file downloader for homelab users who want unattended, continuous archiving of files from channels and groups, with…

  • Backup
  • Downloaders
  • Tools & Utilities
Telegram Files is a self-hosted Telegram file downloader for homelab users who want unattended, continuous archiving of files from channels and groups, with multi-account and pause/resume support.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

64/100 Good

Maintained
76last commit 87 days ago
Popular
682,429 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 17 days ago

GitHub stars
2,429
Open issues
33
Last commit
2026-08-26
Latest release
0.4.0
License
MIT
Activity
stale

Checked 5 days ago - source: GitHub (jarvis2f/telegram-files)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install Java 17 before starting Install the OpenJDK 17 Java Runtime Environment on your server and confirm it works with `java -version`. Without the right Java version, the Telegram-Files app will not start. source
  • Use your real bot username and token Replace the example bot username and token with the real ones from @BotFather before running the app. If you leave placeholder values in place, the bot will not connect or will behave like the wrong bot. source

Fetched 53 days ago - each note links to its source

Alternatives (12)

  • Mirotalk - Mirotalk is a free, web-based video conferencing tool.
  • Pidgin - Pidgin is a cross-platform chat program that lets you log into multiple messaging networks at once, such as XMPP (Extensible Messaging and…
  • Signal - Signal is a messaging app with privacy at its core.
  • SimpleX Chat - SimpleX Chat is a private messaging app that protects your identity by not using phone numbers or usernames.
  • Stoat Chat - Instant messaging with text, voice, video calling, screen sharing, privacy controls, customizable permissions, moderation, bots, and open-s…
  • Tencent QQ - QQ is a widely used Chinese instant messaging service developed by Tencent, offering chat, voice, and video communication.
  • Threema - Threema is a new mobile messaging app that puts security first.
  • Tox - With the rise of widespread government monitoring programs, Tox is an easy to use application that allows you to connect with friends and l…
  • Tuwunel - Tuwunel is a high-performance Matrix homeserver written in Rust, providing self-hosters a scalable, low-cost alternative to Synapse and a m…
  • WhatsApp - Free messaging without SMS fees, web sync, and multimedia sharing, supporting group and video chats, available on iPhone, Android, and desk…
  • Wire - User-friendly messaging platform with end-to-end encrypted chats, voice and video calls, self-deleting messages, file sharing features, and…
  • Zulip - Zulip is an open-source organized team chat app that uses topic-based threading to help remote teams keep conversations structured and prod…

Checked 40 days ago - source: AlternativeTo

Common questions

What should I check if Telegram-Files will not start or the bot does not connect?

Install OpenJDK 17 Java Runtime Environment on the server before starting the app. Replace the example bot username and token with the real ones from @BotFather, because placeholder values can prevent connection or cause wrong-bot behavior.

Can it download files from Telegram channels and groups?

Yes, it is designed for downloading files from Telegram channels and groups.

Can it manage multiple Telegram accounts at the same time?

Yes, it supports multiple Telegram accounts. It can manage and download files simultaneously.

Can downloads be paused and resumed?

Yes, the application provides pause and resume download features.

Can it be deployed with Docker?

Yes, the install guide is for self-hosting telegram-files with Docker.

Is it intended for unattended operation?

Yes, it is described as a self-hosted downloader for continuous, stable, and unattended downloads.

Answers sourced from core.telegram.org, github.com, selfhost.directory

Community

Collected 49 days ago - public community threads