Turn Telegram into your
Private, Unlimited Cloud
A safe, resumable, and autonomous personal file uploader for Windows and Linux. Gradually scans local folders, queues files in SQLite, and uploads directly to your private Saved Messages or Channel with intelligent flood-wait protection.
irm "https://github.com/amjadlle/TeleDrive/releases/download/v1.0.0/TeleDrive-Setup-1.0.0.exe" -OutFile "$env:TEMP\TeleDrive-Setup.exe"; Start-Process "$env:TEMP\TeleDrive-Setup.exe"Engineered for Complete Transparency
Explore the PySide6 desktop client interface. Click any screenshot below to inspect high-resolution details in full view.
Built for Safety, Built for Scale
Unlike generic upload scripts that get accounts restricted, TeleDrive was engineered from day one to treat Telegram API limits with extreme care.
Adaptive Flood-Wait Shield
When Telegram returns FLOOD_WAIT_X, TeleDrive honors the exact cooldown plus an extra configurable safety buffer (e.g. +30s) instead of failing or hammering the server.
Resumable SQLite Engine
All scanned files, queue states, and batch audit logs are committed to an ACID-compliant local SQLite database. Restart your PC anytime without losing progress.
Randomized Jitter Delays
Avoid robotic request signatures. Configurable minimum and maximum intervals (e.g., 20–60 sec) ensure uploads mimic natural human pacing.
Direct to Saved Messages
Upload directly to your private "Saved Messages" or a private backup channel. No third-party relay servers, no telemetry, and no middleware subscriptions.
Zero Dependency Binary
Available as a standalone Windows .exe installer and portable Linux x86_64 bundle. No Python setup, pip packages, or virtual environments needed.
Automatic Loop & Scheduler
Set TeleDrive on autopilot with hourly or daily batch intervals. Single-process locking ensures multiple instances never clash or overlap.
Timing & Safety Simulator
Calculate your backup throughput and simulate Telegram rate-limit safety scores before running your first batch.
Excellent. Natural upload jitter prevents Telegram flood-waits and protects your session.
Recommended Safety Presets
Field-tested default configurations crafted for private personal backup archives without triggering Telegram spam filters.
| Setting Name | Recommended Value | Operational Purpose | Type |
|---|---|---|---|
| Files per run | 20 | Maximum files processed in one continuous execution batch. | Batch Control |
| Files per day | 500 | Hard daily cap across all automatic and manual batches combined. | Daily Quota |
| Delay between uploads (min / max) | 20s – 60s | TeleDrive selects a random wait time within this window after each file. | Jitter Interval |
| Delay between automatic runs | 60 min | Rest period before the scheduler initiates the next queue scan and upload. | Scheduler |
| Retry attempts per file | 3 | Number of automated retry attempts after transient network disconnects. | Resilience |
| Retry backoff base | 30 sec | Exponential delay scale (30s, 60s, 120s) between failed retries. | Backoff |
| Flood-wait buffer | +30 sec | Extra cushion added to server-mandated cooldowns to guarantee safety. | Protection |
| Send files as | Document | Preserves raw bit-for-bit file integrity without Telegram compression. | Storage Format |
Why Telegram limits matter
Telegram dynamically enforces sliding-window rate limits based on account age and destination. Always keep one TeleDrive process running at a time, upload directly to your private me (Saved Messages) or private channel, and avoid using the same phone number for bulk chat messaging while an archive batch is active.
Up and Running in 4 Steps
No technical configuration hurdles. Get your personal automated cloud backup running in minutes.
Obtain Telegram API Keys
Log in to my.telegram.org with your phone number. Under API Development Tools, grab your api_id and api_hash. This takes less than 60 seconds.
https://my.telegram.org/appsConfigure Target & Timing
In TeleDrive Settings, input your keys and set the target to 'me' (Saved Messages) for a safe test. Select your source folder to back up.
Target: me (Saved Messages)Recursive Folder Scan
Click 'Scan Folder'. TeleDrive recursively indexes all files into its local SQLite database, generating deduplicated file hashes.
SQLite queue indexed instantlyLaunch Autonomous Backup
Click 'Run Batch' or toggle the 'Loop Scheduler'. TeleDrive uploads file-by-file with randomized delays, automatically logging every event.
Auto-resumes across rebootsAmjad P A
Everything You Need to Know
Detailed answers on security, storage locations, account limits, and platform compatibility.
Is it safe for my Telegram account to upload files?
Yes. TeleDrive uses official Telethon client sessions via Telegram's standard MTProto protocol. Unlike aggressive mass-uploaders, TeleDrive is deliberately designed with slow, randomized delays (e.g. 20-60s) and respects every FLOOD_WAIT signal with extra buffers to prevent rate-limit penalties.
Where are my Telegram session keys and database stored?
Everything is stored 100% locally on your machine. On Windows: %LOCALAPPDATA%\Telegram Auto Upload, and on Linux: ~/.local/share/Telegram Auto Upload. TeleDrive contains zero analytics, zero external API pings, and zero telemetry.
Do I need Python installed to run TeleDrive?
No! The Windows release comes with a standalone per-user installer (.exe) that bundles everything. The Linux release includes a portable x86_64 pre-compiled package. Python is only needed if you wish to hack on the source code.
What happens if my computer restarts during an upload?
TeleDrive uses a persistent SQLite database. Every scanned file and upload state is tracked with ACID transactions. When you reboot and restart TeleDrive, it immediately resumes exactly where it left off without duplicate re-uploads.
Can I upload to a private Channel instead of Saved Messages?
Yes! In TeleDrive Settings, you can set the target to any channel username (e.g., @my_backup_channel) or channel ID where your account has permission to post.
Is Two-Step Verification (2FA) supported?
Yes. When logging in for the first time, TeleDrive prompts you in the desktop app for your phone code and, if enabled, your 2FA cloud password securely.