Back to Projects
TeleDrive logo

TeleDrive

An open-source, cross-platform desktop application that turns Telegram into a personal media backup for photos, videos, documents, and other files.

Talk about a similar project

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

PythonAstroTelethonPySide6SQLitePyYAMLasyncioPyInstallerInno Setup

Quick install

Run TeleDrive on your machine

Download a prebuilt release or copy the platform-specific command.

All releases
Download Windows installer

More Projects