Tele Drive

Abstract

1. Introduction

TeleDrive stores your files in a private Telegram channel on your own account. There is no TeleDrive server and no account to create with us. The app keeps a local index so browsing and search stay fast and work offline.

[](#requirements) [](#requirements) [](#requirements) [](#requirements) [](https://kotlinlang.org) [](https://www.jetbrains.com/compose-multiplatform/) [](https://github.com/Mahmud0808/TeleDrive/releases/latest) [](https://github.com/Mahmud0808/TeleDrive/releases) [](LICENSE)

One Compose Multiplatform codebase ships the Android app and the Windows, Ubuntu x86_64 and macOS desktop apps. They share the storage engine, encryption, transfers and the entire UI layer, and all of them browse the same drive.

2. Objective

Turn a private Telegram channel into your personal cloud drive. Android, Windows, Linux and macOS, auto backup, optional E2E encryption, built-in file manager and player.

This project demonstrates how Kotlin, Android, Jetpack Compose can be applied to a real-world Cybersecurity & Ethical Hacking problem.

3. Key Features / Modules

• Automatic backup: photos and chosen folders upload on their own on Android, with schedules, Wi-Fi and charging rules, and exclusion patterns
• No file size limit: a 20 GB video is one file in the app, whatever Telegram caps a message at
• Encryption: optional AES-256-GCM for file bodies, names, captions and the folder tree
• File management: folders, favorites, hidden and archived items, trash and bulk actions
• Streaming: video and audio play straight from Telegram with seeking, encrypted files included
• Previews: images, PDFs, text and ZIP contents open inline
• Multiple drives: separate channels for personal, work or photos on one account
• Sharing: files arrive from the Android share sheet, and identical bytes are never uploaded twice
• Transfers: parallel queue with pause and resume that survives reboots
• Recovery: reinstall, sign in, enter your passphrase, and the whole drive is back

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Android Studio (latest)
• JDK 17
• Android device or emulator
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/Mahmud0808/TeleDrive.git
cd TeleDrive

1. Enter your API ID and hash.
2. Sign in, either by phone number and login code, or by choosing Sign in by
3. Choose the folders to back up.
4. Optionally enable Encrypt uploads and set a recovery passphrase.

git clone https://github.com/Mahmud0808/TeleDrive.git
cd TeleDrive
./gradlew :android:installDebug  # Android
./gradlew :desktop:run           # Windows/Linux desktop

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add logging and alert notifications (email / Telegram)
• Write a threat model document for the tool
• Package it with Docker for safe lab testing

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which threat or attack does this project defend against?
2. What detection or protection technique is used and what are its limits?
3. How are false positives and false negatives handled?
4. Which cryptographic algorithms or security standards are involved?
5. What legal and ethical rules apply when testing a tool like this?

9. Source Code & License

This project is developed by Mahmud0808 and published on GitHub under the Apache License 2.0. Please follow the license terms and credit the original author when you use or modify this code.