{"id":44063064,"url":"https://github.com/caamer20/telegram-drive","last_synced_at":"2026-06-02T08:00:40.771Z","repository":{"id":337130627,"uuid":"1140832724","full_name":"caamer20/Telegram-Drive","owner":"caamer20","description":"Turn your Telegram account into an unlimited, secure cloud storage drive. an Open-source desktop app built with Tauri, Rust, and React.","archived":false,"fork":false,"pushed_at":"2026-05-30T00:03:56.000Z","size":126420,"stargazers_count":3204,"open_issues_count":3,"forks_count":464,"subscribers_count":14,"default_branch":"main","last_synced_at":"2026-05-30T01:20:10.736Z","etag":null,"topics":["open-source","react","rust","tauri","telegram","telegramapi","typescript"],"latest_commit_sha":null,"homepage":"https://www.cameronamer.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/caamer20.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":"https://www.buymeacoffee.com/caamer20"},"created_at":"2026-01-23T20:19:39.000Z","updated_at":"2026-05-30T00:43:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/caamer20/Telegram-Drive","commit_stats":null,"previous_names":["caamer20/telegram-drive"],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/caamer20/Telegram-Drive","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caamer20%2FTelegram-Drive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caamer20%2FTelegram-Drive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caamer20%2FTelegram-Drive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caamer20%2FTelegram-Drive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caamer20","download_url":"https://codeload.github.com/caamer20/Telegram-Drive/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caamer20%2FTelegram-Drive/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33812204,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["open-source","react","rust","tauri","telegram","telegramapi","typescript"],"created_at":"2026-02-08T02:28:26.086Z","updated_at":"2026-06-02T08:00:40.765Z","avatar_url":"https://github.com/caamer20.png","language":"TypeScript","funding_links":["https://www.paypal.me/Caamer20"],"categories":[],"sub_categories":[],"readme":"# Telegram Drive\n\n**Telegram Drive** is an open-source, cross-platform desktop application that turns\nyour Telegram account into an unlimited, secure cloud storage drive. Built with\n**Tauri**, **Rust**, and **React**.\n\n\u003cdiv align=\"center\"\u003e\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20MacOS%20%7C%20Linux-blue)]()\n![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/caamer20/Telegram-Drive/total?style=flat)\n[![oosmetrics](https://api.oosmetrics.com/api/v1/badge/achievement/ae8e5a6b-e815-4799-a408-4a59980cf9c8.svg)](https://oosmetrics.com/repo/caamer20/Telegram-Drive)\n[![oosmetrics](https://api.oosmetrics.com/api/v1/badge/achievement/029fb97b-a54a-4566-a1eb-aa1a5039065d.svg)](https://oosmetrics.com/repo/caamer20/Telegram-Drive)\n[![oosmetrics](https://api.oosmetrics.com/api/v1/badge/achievement/2aa6f3f9-fd8a-4523-bd73-6625ee6a948a.svg)](https://oosmetrics.com/repo/caamer20/Telegram-Drive)\n\n\u003c/div\u003e\n\n![Auth Screen](screenshots/AuthScreen.png)\n\n##  What is Telegram Drive?\n\nTelegram Drive leverages the Telegram API to allow you to upload, organize, and manage files directly on Telegram's servers. It treats your \"Saved Messages\" and created Channels as folders, giving you a familiar file explorer interface for your Telegram cloud.\n\n###  Key Features\n\n*   **Unlimited Cloud Storage**: Utilizing Telegram's generous cloud infrastructure.\n*   **High Performance Grid**: Virtual scrolling handles folders with thousands of files instantly.\n*   **Auto-Updates**: Seamless updates for Windows, macOS, and Linux.\n*   **Media Streaming**: Stream video and audio files directly without downloading.\n*   **PDF Viewer:** Built-in PDF support with infinite scrolling for seamless document reading.\n*   **Drag \u0026 Drop**: Intuitive drag-and-drop upload and file management.\n*   **Thumbnail Previews**: Inline thumbnails for images and media files.\n*   **Folder Management**: Create \"Folders\" (private Telegram Channels) to organize content.\n*   **Shareable Links**: Generate direct download links with optional password protection and expiration, and revoke access anytime from the dashboard. Also supports copying native Telegram message links for files in public channels.\n*   **REST API for AI Integration**: Secure local API (off by default) with configurable port and API key auth. OpenAPI spec for seamless LLM and tool integration.\n*   **Proxy Support**: Native integration for SOCKS5 and MTProto proxies to bypass regional restrictions and secure your traffic.\n*   **VPN Optimizer**: Aggressive network tuning including bandwidth throttling, adjustable transfer chunk sizing, and adaptive keep-alives to ensure maximum stability on high-latency connections.\n*   **Privacy Focused**: API keys and data stay local. No third-party servers.\n*   **Cross-Platform**: Native apps for macOS (Intel/ARM), Windows, Linux and Android.\n\n## Android (Pre‑built, Unsigned APK)\n\nA pre-built **unsigned APK** is available for Android sideloading via the [v2.1.5-android release](https://github.com/caamer20/Telegram-Drive/releases/tag/Androidv2.1.5beta).\n\n\u003e [!WARNING]\n\u003e This APK is **not signed** and is **not available on the Google Play Store**. You must enable \"Install from Unknown Sources\" on your device to install it. This build contains **Google AdMob banner ads** to support development.\n\n### How to Sideload\n\n1. Download `Telegram-Drive-v2.1.0-beta.apk` from the [v2.1.5-android release](https://github.com/caamer20/Telegram-Drive/releases/tag/Androidv2.1.5beta).\n2. On your Android device, go to **Settings → Apps → Special App Access → Install unknown apps** and allow your browser or file manager.\n3. Open the downloaded APK and tap **Install**.\n4. Enter your Telegram API credentials on first launch (same as the desktop app).\n\n\u003e [!NOTE]\n\u003e - **Compatibility**: Requires **Android 7.0 (API level 24)** or higher.\n\u003e - **Android 15+ Installation**: If you encounter blocks or security restrictions when installing on Android 15+ emulator/device, bypass it using ADB:\n\u003e   ```bash\n\u003e   adb install --bypass-low-target-sdk-block Telegram-Drive-v2.1.0-beta.apk\n\u003e   ```\n\u003e - The Android build is a **community/beta release** compiled locally. The desktop app (Windows/macOS/Linux) remains the primary supported platform, built and signed automatically by GitHub CI.\n\n---\n\n##  Screenshots\n\n### Desktop App\n\n| Dashboard | File Preview |\n|-----------|--------------|\n| ![Dashboard](screenshots/DashboardWithFiles.png) | ![Preview](screenshots/ImagePreview.png) |\n\n| Grid View | Authentication |\n|-----------|----------------|\n| ![Dark Mode](screenshots/DarkModeGrid.png) | ![Login](screenshots/LoginScreen.png) |\n\n| Audio Playback | Video Playback |\n|----------------|----------------|\n| ![Audio Playback](screenshots/AudioPlayback.png) | ![Video Playback](screenshots/VideoPlayback.png) |\n\n| Auth Code Screen | Upload Example |\n|------------------|-------------|\n| ![Auth Code Screen](screenshots/AuthCodeScreen.png) | ![Upload Example](screenshots/UploadExample.png) |\n\n| Folder Creation | Folder List View |\n|-----------------|------------------|\n| ![Folder Creation](screenshots/FolderCreation.png) | ![Folder List View](screenshots/FolderListView.png) |\n\n### Android App\n\n| Home Screen | Splash Screen | Dark Mode Folder View |\n|-------------|---------------|-----------------------|\n| ![Home Screen](screenshots/AndroidHomeScreenWithIcon.png) | ![Splash Screen](screenshots/AndroidTelegram-DriveSplash.png) | ![Dark Mode Folder View](screenshots/AndroidDarkModeFolderView.png) |\n\n| Folder List | Transfer Queue | Settings Page |\n|-------------|----------------|---------------|\n| ![Folder List](screenshots/AndroidFolderList.png) | ![Transfer Queue](screenshots/AndroidTransferQue.png) | ![Settings Page](screenshots/AndroidSettingsPage.png) |\n\n##  Tech Stack\n\n*   **Frontend**: React, TypeScript, TailwindCSS, Framer Motion\n*   **Backend**: Rust (Tauri), Grammers (Telegram Client)\n*   **Build Tool**: Vite\n\n\n##  Getting Started\n\n### Prerequisites\n\n*   **Node.js (v18+)**: [Download here](https://nodejs.org/)\n*   **Rust (latest stable)**: Required to compile the Tauri backend. Install via [rustup](https://rustup.rs/):\n    *   **macOS/Linux:** `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh`\n    *   **Windows:** Download and run `rustup-init.exe` from [rustup.rs](https://rustup.rs/)\n    *   *Verify installation:* run `rustc --version` and `cargo --version` in your terminal.\n*   **OS-Specific Build Tools for Tauri**: \n    *   **macOS:** Xcode Command Line Tools (`xcode-select --install`).\n    *   **Linux (Ubuntu/Debian):** `sudo apt update \u0026\u0026 sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev`\n    *   **Windows (CRITICAL):** You **must** install the [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/). During installation, select the **\"Desktop development with C++\"** workload. Without this, you will get a `linker 'link.exe' not found` error.\n    *   **Windows (WebView2):** Windows 10/11 users usually have this pre-installed. If not, download the [WebView2 Runtime](https://developer.microsoft.com/en-us/microsoft-edge/webview2/#download-section).\n    *   *Reference:* See the official [Tauri v2 Prerequisites Guide](https://v2.tauri.app/start/prerequisites/) for detailed instructions.\n*   **Telegram API Credentials**: You need your own API ID and API Hash to communicate with Telegram's servers.\n    1. Log into [my.telegram.org](https://my.telegram.org).\n    2. Go to \"API development tools\" and create a new application to get your `api_id` and `api_hash`.\n\n\u003e [!NOTE]  \n\u003e **First-run Compile Time:** The initial build (`npm run tauri dev` or `npm run tauri build`) will download and compile over 300 Rust crates. This process can take **5 to 15 minutes** depending on your hardware. Subsequent builds will be much faster.\n\n\u003e [!TIP]\n\u003e **NPM Vulnerabilities:** You may see vulnerability warnings during `npm install`. These are usually related to build tools and dev dependencies. You can optionally run `npm audit fix`, but it is not strictly required to run the app.\n\n### Installation\n\n1.  **Clone the repository**\n    ```bash\n    git clone https://github.com/caamer20/Telegram-Drive.git\n    cd Telegram-Drive\n    ```\n\n2.  **Install Dependencies**\n    ```bash\n    cd app\n    npm install\n    ```\n\n3.  **Run in Development Mode**\n    ```bash\n    npm run tauri dev\n    ```\n\n4.  **Build/Compile**\n    ```bash\n    npm run tauri build\n    ```\n\n##  Open Source \u0026 License\n\nThis project is **Free and Open Source Software**. You are free to use, modify, and distribute it.\n\nLicensed under the **MIT License**.\n\n---\n*Disclaimer: This application is not affiliated with Telegram FZ-LLC. Use responsibly and in accordance with Telegram's Terms of Service.*\n\nIf you're looking for a version of this app that's optimized for VPNs check out this repo:\nhttps://github.com/caamer20/Telegram-Drive-ForVPNs\n\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- PayPal --\u003e\n  \u003cdiv style=\"margin: 15px 0;\"\u003e\n    \u003ca href=\"https://www.paypal.me/Caamer20\"\u003e\n      \u003cimg src=\"https://raw.githubusercontent.com/stefan-niedermann/paypal-donate-button/master/paypal-donate-button.png\" alt=\"Donate with PayPal\" width=\"200\"\u003e\n    \u003c/a\u003e\n    \u003cdiv style=\"font-size: 14px; margin-top: 8px;\"\u003epaypal.me/Caamer20\u003c/div\u003e\n  \u003c/div\u003e\n\n  \u003c!-- Litecoin --\u003e\n  \u003cdiv style=\"margin: 15px 0;\"\u003e\n    \u003ca href=\"litecoin:ltc1q6wkr5ac4u0pxx4hx7xgwn0gsaku25ws0df73rp\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Donate-LTC-345D9D?style=for-the-badge\u0026logo=litecoin\u0026logoColor=white\" alt=\"Donate LTC\"\u003e\n    \u003c/a\u003e\n    \u003cdiv style=\"font-family: monospace; font-size: 13px; margin-top: 8px; word-break: break-all;\"\u003e\n      ltc1q6wkr5ac4u0pxx4hx7xgwn0gsaku25ws0df73rp\n    \u003c/div\u003e\n  \u003c/div\u003e\n\n  \u003c!-- Bitcoin --\u003e\n  \u003cdiv style=\"margin: 15px 0;\"\u003e\n    \u003ca href=\"bitcoin:bc1q5pt7m2fk6w0dzsnf6vvd5k6nw5k44785286ujy\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Donate-BTC-F7931A?style=for-the-badge\u0026logo=bitcoin\u0026logoColor=white\" alt=\"Donate BTC\"\u003e\n    \u003c/a\u003e\n    \u003cdiv style=\"font-family: monospace; font-size: 13px; margin-top: 8px; word-break: break-all;\"\u003e\n      bc1q5pt7m2fk6w0dzsnf6vvd5k6nw5k44785286ujy\n    \u003c/div\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaamer20%2Ftelegram-drive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaamer20%2Ftelegram-drive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaamer20%2Ftelegram-drive/lists"}