TGDrive is a native macOS app that uses a private Telegram channel as file storage. It is built with SwiftUI, TDLib, and a local SQLite index.
The app is designed around a simple rule: Telegram is the source of truth. The local database is only an index/cache so the UI can stay fast.
- Sign in with Telegram API ID/API hash, phone verification, and optional 2FA.
- Automatically creates or reuses a private
TGDrive StorageTelegram channel. - Upload files from the toolbar, file picker, or drag and drop.
- Upload folders by automatically packaging them as
<FolderName>.zip. - Uses no-compression zip packaging for folders so large folders prepare faster.
- Syncs the file list from Telegram on launch and through
Sync Storage. - Deletes files from the Telegram storage channel, not only from the local UI.
- Downloads files to
~/Downloads/TGDrive/. - Opens previewable files with native Quick Look.
- Keeps local cache and metadata in Application Support / Caches.
Files upload directly to Telegram.
Folders are prepared locally first:
- TGDrive scans the folder.
- TGDrive creates a zip using the same folder name.
- Telegram upload starts.
- TGDrive inserts the file into the local index only after TDLib confirms the message was sent.
This prevents fake rows where the app shows a file that Telegram never received.
Downloaded files are saved to:


