
TeleDrive
An open-source, cross-platform desktop application that turns Telegram into a personal media backup for photos, videos, documents, and other files.
About
TeleDrive is an open-source Python desktop application for safely backing up local media to Telegram, with free builds for Windows and Linux. Users select a source folder, configure upload limits and delays, and let the application process files gradually, often overnight. Files are uploaded one at a time to a private Telegram channel or Saved Messages, while a local SQLite record tracks every file so interrupted uploads can resume safely after restarts. TeleDrive is designed for one-way backup and archiving, not two-way synchronization: it preserves files in their original form and provides access through Telegram from other devices.
Key Features
- Personal media backup through Telegram
- Open-source project with Windows and Linux support
- Photos, videos, documents, and other file types
- Resumable uploads with persistent SQLite state and upload history
- Recursive source-folder scanning with queue management and one-file-at-a-time processing
- Configurable files-per-run and files-per-day limits
- Configurable delays between uploads
- Retry attempts with exponential backoff
- Telegram flood-wait and rate-limit handling with persistent authentication
- Detection of missing or modified source files
- Private channel or Saved Messages support
- Document, media, and automatic Telegram upload modes
- Automatic upload loop with configurable intervals
- Start, stop, clear activity, and reset tracking controls
- Live dashboard for progress, queue, history, and activity logs
- Interactive PySide6 desktop interface
- CLI mode for scripting and diagnostics
- Single-process locking to prevent overlapping jobs
- Packaged Windows executable and per-user installer
- Linux build script producing a distributable archive
- One-way backup and archiving with no automatic deletion mirroring
- Cross-platform source support for Windows and Linux
Info
Tech
Quick install
Run TeleDrive on your machine
Download a prebuilt release or copy the platform-specific command.

