How vengatz-git/file-downloader works
Telegram File Downloader resolves Telegram message links through a VPS-hosted MTProto backend, then streams media to either the web/PWA client or the Android app. The Python and Node.js backends are alternative implementations. The graph follows the documented resolve-to-stream flow and sampled Android/Python calls; web, Node.js, and some UI wiring are represented only where the README documents them.
Main entry points: main.py FastAPI app · app.js Web downloader · MainScreen.kt Downloader screen · MainViewModel.kt Download state
Components 20
Web client
- Web downloader
web/app.js - PWA shell
web/sw.js
Android client
- App entry
android/app/src/main/java/com/tgdownloader/app/MainActivity.kt - Downloader screen
android/app/src/main/java/com/tgdownloader/app/ui/screen/MainScreen.kt - Download state
android/app/src/main/java/com/tgdownloader/app/ui/viewmodel/MainViewModel.kt - UI state
android/app/src/main/java/com/tgdownloader/app/ui/viewmodel/MainUiState.kt - File and progress models
android/app/src/main/java/com/tgdownloader/app/domain/model/FileMetadata.kt - Download repository
android/app/src/main/java/com/tgdownloader/app/data/repository/TelegramRepositoryImpl.kt - Repository contract
android/app/src/main/java/com/tgdownloader/app/domain/repository/TelegramRepository.kt - HTTP API client
android/app/src/main/java/com/tgdownloader/app/data/remote/TelegramApiService.kt - Network setup
android/app/src/main/java/com/tgdownloader/app/data/remote/NetworkModule.kt - Compose theme
android/app/src/main/java/com/tgdownloader/app/ui/theme/Color.kt
Python backend
- FastAPI app
backend/app/main.py - Resolve and stream routes
backend/app/api/routes.py - Telethon manager
backend/app/core/telegram.py - Backend settings
backend/app/core/config.py - API schemas
backend/app/schemas/file.py
Node backend
- Express MTProto backend
backend-node/server.js
Other components
- User
- Telegram Cloud
Connections 28
- User → Web downloader: submits link
README.md - Web downloader → FastAPI app: calls API
README.md - Web downloader → Express MTProto backend: calls API
README.md - Web downloader → PWA shell: uses offline shell
- User → App entry: opens app
- App entry → Downloader screen: shows
android/app/src/main/java/com/tgdownloader/app/MainActivity.kt - Downloader screen → Download state: invokes actions
android/app/src/main/java/com/tgdownloader/app/ui/screen/MainScreen.kt - Download state → UI state: updates
android/app/src/main/java/com/tgdownloader/app/ui/viewmodel/MainViewModel.kt - Download state → Repository contract: calls
android/app/src/main/java/com/tgdownloader/app/ui/viewmodel/MainViewModel.kt - Download state → Download repository: constructs
android/app/src/main/java/com/tgdownloader/app/ui/viewmodel/MainViewModel.kt - Download repository → HTTP API client: requests
android/app/src/main/java/com/tgdownloader/app/data/repository/TelegramRepositoryImpl.kt - Network setup → HTTP API client: configures
android/app/src/main/java/com/tgdownloader/app/data/remote/NetworkModule.kt - Download repository → File and progress models: maps and reports
android/app/src/main/java/com/tgdownloader/app/data/repository/TelegramRepositoryImpl.kt - Downloader screen → File and progress models: renders metadata and progress
android/app/src/main/java/com/tgdownloader/app/ui/screen/MainScreen.kt - Downloader screen → Compose theme: uses colors
android/app/src/main/java/com/tgdownloader/app/ui/screen/MainScreen.kt - HTTP API client → FastAPI app: HTTP requests
README.md - HTTP API client → Express MTProto backend: HTTP requests
README.md - FastAPI app → Resolve and stream routes: mounts routes
backend/app/main.py - FastAPI app → Telethon manager: starts and stops
backend/app/main.py - FastAPI app → Backend settings: reads settings
backend/app/main.py - FastAPI app → Web downloader: serves static client
backend/app/main.py - Resolve and stream routes → Telethon manager: resolves and streams
backend/app/api/routes.py - Resolve and stream routes → Backend settings: builds stream URL
backend/app/api/routes.py - Resolve and stream routes → API schemas: validates and responds
backend/app/api/routes.py - Telethon manager → Backend settings: uses credentials and chunk size
backend/app/core/telegram.py - Telethon manager → Telegram Cloud: MTProto access
README.md - Express MTProto backend → Telegram Cloud: MTProto access
README.md - FastAPI app → User: serves downloads