# tgdrive/teldrive

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/tgdrive-teldrive).**

2,950 stars · 428 forks · Go · MIT

## Links

- GitHub: https://github.com/tgdrive/teldrive
- Homepage: https://teldrive-docs.pages.dev
- awesome-repositories: https://awesome-repositories.com/repository/tgdrive-teldrive.md

## Topics

`drive` `golang` `rclone` `teldrive` `teledrive` `telegram` `telegram-bot` `telegramdrive`

## Description

Teldrive is a web-based cloud storage interface that uses Telegram as a backend for storing and organizing files. It functions as an encrypted cloud drive and a remote storage bridge, allowing users to manage files through a dedicated file manager.

The system optimizes data throughput by using a proxy to aggregate multiple authentication tokens, which bypasses single-account rate limits to increase upload and download speeds. It ensures data privacy through per-file salt encryption for both file data and metadata.

The project covers remote file management, including the ability to mount storage as a standard remote volume for synchronization with other cloud services. It includes capabilities for private media hosting with external media server integration, multi-threaded stream buffering to reduce playback latency, and on-the-fly image thumbnail generation.

Administrative features include database-backed file indexing, automated backup and restoration, and access control based on signed tokens and username whitelists.

## Tags

### Business & Productivity Software

- [Telegram Cloud Storage Interfaces](https://awesome-repositories.com/f/business-productivity-software/telegram-cloud-storage-interfaces.md) — Provides a dedicated web interface to use Telegram as a backend for storing and organizing files.

### User Interface & Experience

- [File Browser Interfaces](https://awesome-repositories.com/f/user-interface-experience/file-browser-interfaces.md) — Provides a dedicated web-based file manager interface to organize and access files stored on Telegram. ([source](https://teldrive-docs.pages.dev/))

### Part of an Awesome List

- [File Encryption](https://awesome-repositories.com/f/awesome-lists/security/file-encryption.md) — Secures files using per-file salt encryption to ensure data remains private without a master key. ([source](https://teldrive-docs.pages.dev/docs/))
- [Salted Per-File Encryption](https://awesome-repositories.com/f/awesome-lists/security/file-encryption/deterministic-per-file-encryptions/salted-per-file-encryption.md) — Secures individual files using unique salts and a master key to ensure data privacy in remote storage.
- [Metadata Encryption](https://awesome-repositories.com/f/awesome-lists/security/metadata-encryption.md) — Secures sensitive file information using a configurable encryption key to prevent unauthorized data recovery. ([source](https://teldrive-docs.pages.dev/docs/getting-started/usage))

### Content Management & Publishing

- [Telegram Channel Indexing](https://awesome-repositories.com/f/content-management-publishing/remote-channel-synchronizers/telegram-channel-indexing.md) — Imports and indexes channels from a Telegram account to organize files within the user interface. ([source](https://teldrive-docs.pages.dev/docs/getting-started/usage))

### Data & Databases

- [Remote File Metadata Indexing](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/indexing-architectures/pluggable-indexing-engines/system-file-indexers/remote-file-metadata-indexing.md) — Tracks remote file metadata and parts in a local database to enable fast searching and integrity verification.
- [Backup and Recovery](https://awesome-repositories.com/f/data-databases/backup-and-recovery.md) — Schedules automated backups and restores of database states and files to remote providers.
- [External Storage Bridging](https://awesome-repositories.com/f/data-databases/data-engineering/cloud-native-storage-layers/remote-storage-mounts/external-storage-bridging.md) — Uses remote storage commands to manage and synchronize files through an external storage bridge. ([source](https://teldrive-docs.pages.dev/docs/guides/rclone))

### DevOps & Infrastructure

- [API Token Aggregation](https://awesome-repositories.com/f/devops-infrastructure/data-throughput-optimizers/api-token-aggregation.md) — Implements a proxy that aggregates multiple authentication tokens to bypass Telegram rate limits and increase transfer speeds. ([source](https://teldrive-docs.pages.dev/docs/getting-started/advanced))
- [Telegram Uploaders](https://awesome-repositories.com/f/devops-infrastructure/file-uploaders/telegram-uploaders.md) — Optimizes file transfers to Telegram by controlling concurrent upload threads and retry attempts. ([source](https://teldrive-docs.pages.dev/docs/cli/run))
- [High-Performance Data Transfer](https://awesome-repositories.com/f/devops-infrastructure/high-performance-data-transfer.md) — Bypasses API rate limits using multiple authentication tokens to maximize upload and download speeds.
- [API Key Pools](https://awesome-repositories.com/f/devops-infrastructure/rate-limiters/distributed-rate-limiting/api-key-pools.md) — Distributes API requests across a pool of multiple authentication tokens to bypass single-account rate limits.
- [Remote File System Mounts](https://awesome-repositories.com/f/devops-infrastructure/remote-file-system-mounts.md) — Mounts Telegram storage as a standard remote volume for synchronization and file management.
- [Cloud Storage Integrations](https://awesome-repositories.com/f/devops-infrastructure/cloud-storage-integrations.md) — Mounts files as a standard remote storage volume and synchronizes with other cloud services. ([source](https://teldrive-docs.pages.dev/docs/))
- [Self-Hosted Media Servers](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-applications/self-hosted-media-servers.md) — Stores encrypted video and audio files on Telegram for streaming via external media servers.

### Networking & Communication

- [Token Aggregation Proxies](https://awesome-repositories.com/f/networking-communication/telegram-api-integrations/token-aggregation-proxies.md) — Aggregates multiple authentication tokens via a gateway to bypass API rate limits and increase throughput.
- [Proxy-Managed Connection Sessions](https://awesome-repositories.com/f/networking-communication/network-reliability-diagnostics/connection-session-management/connection-management/proxy-managed-connection-sessions.md) — Manages API rate limits, proxy settings, and session pooling for stable communication with Telegram. ([source](https://teldrive-docs.pages.dev/docs/cli/run))
- [Remote Media Server Integration](https://awesome-repositories.com/f/networking-communication/remote-media-fetching/remote-media-server-integration.md) — Connects stored files to external media applications to enable streaming of hosted video and audio content. ([source](https://teldrive-docs.pages.dev/docs/guides/jellyfin))

### Security & Cryptography

- [Username Whitelist Access Control](https://awesome-repositories.com/f/security-cryptography/access-control/panel-access-controls/token-access-restrictions/username-whitelist-access-control.md) — Validates user identity through signed tokens and a whitelist of allowed usernames to restrict system access.
- [Encrypted Cloud Storage](https://awesome-repositories.com/f/security-cryptography/encrypted-cloud-storage.md) — Implements a storage layer with per-file salt encryption and metadata security for data on external servers.
- [Username Whitelists](https://awesome-repositories.com/f/security-cryptography/domain-based-access-controls/domain-whitelists/username-whitelists.md) — Validates users against a whitelist of allowed usernames using signed tokens to secure the service. ([source](https://teldrive-docs.pages.dev/docs/cli/run))
- [User Access Controls](https://awesome-repositories.com/f/security-cryptography/user-access-controls.md) — Limits system access to specific usernames to ensure only authorized individuals can manage files. ([source](https://teldrive-docs.pages.dev/docs/getting-started/usage))

### System Administration & Monitoring

- [Remote File Managers](https://awesome-repositories.com/f/system-administration-monitoring/remote-file-managers.md) — Provides an interface for browsing, editing, and organizing files stored on remote cloud services.

### Web Development

- [Telegram](https://awesome-repositories.com/f/web-development/file-uploads/telegram.md) — Provides a web-based file manager that uses Telegram as a backend for storing and organizing files.

### Graphics & Multimedia

- [On-Demand Thumbnail Generation](https://awesome-repositories.com/f/graphics-multimedia/image-editing-processing/image-editors/image-cropping-tools/on-demand-thumbnail-generation.md) — Intercepts image requests via a proxy to resize assets on the fly and reduce bandwidth usage.
- [Media Stream Buffering](https://awesome-repositories.com/f/graphics-multimedia/media-stream-buffering.md) — Downloads file segments in parallel across multiple connections to minimize playback latency.
- [Streaming Optimizations](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/video-streaming/streaming-optimizations.md) — Utilizes multi-threaded downloads to reduce buffering and increase throughput during large file streaming. ([source](https://teldrive-docs.pages.dev/docs/getting-started/advanced))