TG Drive Docs v1.2.7 Stable
Go to App →

About TG Drive

TG Drive is a premium cloud storage interface designed to transform your Telegram experience into a professional file management system. It utilizes your personal Cloud Storage space to host and organize files of any type.

By connecting directly to the official Telegram servers, the app ensures that your data is always available across all your devices without the typical subscription costs associated with traditional cloud providers.

Tip: TG Drive uses official MTProto 2.0 protocols, meaning your connection is as secure as your Telegram app itself.

What's New (Version 1.2.7)

Stable Release Updates:

  • Smart Pause & Resume: Introduced a robust persistence layer for downloads. You can now pause large transfers and resume them later without losing progress.
  • High-Velocity Transfers: Optimized MTProto chunking and connection pools to significantly increase both uploading and downloading speeds.
  • Real-Time Sync Refined: Resolved critical synchronization bottlenecks, ensuring your file tree and metadata stay perfectly aligned with the Telegram cloud instantly.
  • UI Performance Boost: Eliminated interface lag through aggressive render optimization and streamlined state management.
  • Player Logic Removed: Removed the native Audio/Video streaming player to focus on high-speed direct downloads, ensuring full original file quality and system stability.
  • Service Worker Streaming: Revolutionized the download pipeline with a unified Service Worker architecture. Files now stream directly to the browser's native manager, bypassing memory limits.
  • Swipe-to-Dismiss Panel: The bottom floating progress bar now supports horizontal touch gestures to gracefully hide the panel.

Premium Features

Multipart Architecture

Upload and download massive files efficiently by splitting them into safe, high-speed MTProto chunks.

Pause & Resume

Interrupt and continue downloads seamlessly with chunk-level persistence, saving data and time on large transfers.

Deep Nesting

Unlimited folder depth with lightning-fast smart indexing stored directly in your Telegram cloud.

Local Persistence

Utilizes IndexedDB (idb-keyval) for high-speed local caching and instant app responsiveness.

Zero Server Storage

No data is stored on our servers. Pure peer-to-peer communication via GramJS MTProto.

Bank-Grade Privacy

Leverages Telegram's native encryption and your personal API credentials for absolute security.

System Policies & Limits

Upload Limits

A strict 2.0 GB maximum file size policy is enforced for all uploads. Attempting to upload files larger than this will trigger a system notification.

Additionally, users can upload up to 100 files at once in a single batch. This ensures consistent performance and prevents Telegram API flood errors.

Setup Guide

1

Obtain API Credentials

Visit my.telegram.org, log in, and create a new application to get your API ID and API Hash. These are essential for secure communication.

2

Create a Bot Token

Message @BotFather on Telegram to create a new bot. Copy the Bot Token to enable high-speed metadata handling.

3

Authorize Account

Enter your phone number in the login screen. You will receive an official Telegram code. Enter it to authorize the PWA session locally.

4

Start Organizing

Your 'Saved Messages' is now your cloud vault. Drag and drop files to begin your organized cloud journey.

Storage System

TG Drive employs a Smart Hybrid Storage system that automatically optimizes for file size, speed, and privacy.

Feature MTProto Direct Bot API
File Size Up to 2.0 GB < 20 MB (Fallback)
Privacy 🔒 High Privacy (Direct) ⚡ Medium Privacy (Gateway)
Location Saved Messages (Cloud) Bot Gateway (Bridge)

How It Works

TG Drive acts as an intelligent bridge between your browser and Telegram. It creates a Virtual File System (VFS) by tagging messages with JSON-serialized metadata prefixes.

{
  "prefix": "#TG_DRIVE_FILE#",
  "meta": {
    "fileName": "Project_2026.zip",
    "parentId": "root_vault",
    "totalSize": 2147483648,
    "isMultipart": true
  }
}

When you request a file, the system fetches the raw MTProto chunks via GramJS to rebuild the file locally. This ensures your data remains private and secure throughout the transfer.

Storage Logic

TG Drive utilizes a visual 9999 TB Quota to represent the virtually unlimited nature of Telegram's Saved Messages storage.

Data is categorized in your dashboard into five distinct groups: Images, Videos, Apps & Zips, Documents, and Others.

Warning: Do not manually delete messages in your Telegram app's "Saved Messages" chat. This will permanently break the links in TG Drive.

Common Questions (FAQ)

Is there a file size limit?

Yes, a strict 2.0 GB limit per file is enforced for all users to ensure optimal performance and system stability.

Why do I need a Bot Token?

The Bot Token is used to securely fetch profile photos, PIN recovery codes, and handle high-speed metadata handling without exposing your main MTProto keys.

How do I update credentials?

You can update your credentials anytime via Profile Settings (click your avatar). This allows you to verify and switch bots seamlessly.

Is my data safe?

Yes. Files are stored in your private Saved Messages. TG Drive runs entirely in your browser; session keys stay on your device only.

Secure Vault

The Secure Vault is an advanced protection layer that ensures your Telegram session and credentials are never stored in plain text. It uses military-grade encryption to lock your data behind a personal PIN.

  • AES-GCM Encryption: All sensitive fields (API ID, Hash, Session String) are encrypted using 256-bit AES-GCM before reaching your local database.
  • Zero-Knowledge: We never store your PIN. It exists only in your memory and is used to derive the encryption key on-the-fly via PBKDF2.

Keyboard Shortcuts

  • Close Viewers Esc
  • Quick Search /
  • Mark Favorite F
  • Move to Trash Del

Privacy & Security

Your files and personal data are 101% Secure. TG Drive acts as a specialized interface. We never store your raw files, photos, or documents in our database. Your data stays exactly in your private Telegram Cloud.

Technical Proof (Firebase Rules):

{
  "rules": {
    "admin_controls": {
      ".read": true,
      ".write": "auth != null"
    },
    "stats": {
      ".read": true,
      ".write": true
    },
    "users": {
      ".read": "auth != null",
      ".write": "auth != null",
      "$telegramId": {
        ".read": true,
        ".write": true
      }
    }
  }
}