<p align="center"> <img src="https://cdn.jsdelivr.net/gh/fyaz05/Resources@main/FileToLink/Thunder.jpg" alt="Thunder Logo" width="120"> <h1 align="center">⚡ Thunder</h1> </p> <p align="center"> <b>High-Performance Telegram File-to-Link Bot for Direct Links & Streaming</b> </p> <p align="center"> <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.13%2B-blue?style=for-the-badge&logo=python" alt="Python Version"></a> <a href="https://github.com/Mayuri-Chan/pyrofork"><img src="https://img.shields.io/badge/Pyrofork-red?style=for-the-badge" alt="Pyrofork"></a> <a href="LICENSE"><img src="https://img.shields.io/github/license/fyaz05/FileToLink?style=for-the-badge&color=green" alt="License"></a> <a href="https://t.me/Thunder_Updates"><img src="https://img.shields.io/badge/Telegram-Channel-blue?style=for-the-badge&logo=telegram" alt="Telegram Channel"></a> </p> <hr>

📑 Table of Contents

About The Project
How It Works
Features
Configuration
- Essential Configuration
- Optional Configuration
Usage and Commands
- Basic Usage
- Commands Reference
Advanced Feature Setup
Deployment Guide
Support & Community
- Troubleshooting & FAQ
- Contributing
License
Acknowledgments

<hr>

About The Project

Thunder is a powerful Telegram bot that transforms Telegram files into high-speed direct links, perfect for both streaming and rapid downloading. Share files via HTTP(S) links without needing to download them from the Telegram client first.

💡 Perfect For

🚀 Bypassing Telegram's built-in download speed limits
☁️ Unlimited cloud storage with fast streaming and download links
🎬 Content creators sharing media files
👥 Communities distributing resources
🎓 Educational platforms sharing materials

How It Works

User Uploads File → Telegram Bot → Forwards to Channel → Generates Direct Link → Direct Download / Streaming

Upload → User sends any file to the bot.
Store → The bot forwards the file to your private storage channel (BIN_CHANNEL), where it is permanently saved to generate the link.
Generate → A unique, permanent link is created.
Stream/Download → Anyone with the link can stream or download the file directly in their browser.
Balance → Multi-client support distributes the load for high availability.

Features

Core Functionality

✅ Direct Link Generation - Convert any Telegram file into a direct HTTP(S) link.
✅ Permanent Links - Links remain active as long as the file exists in the storage channel.
✅ Browser Streaming & Downloading - Stream media directly or download files at high speed without a Telegram client.
✅ All File Types - Supports video, audio, documents, images, and any other file format.
✅ Batch Processing - Generate links for multiple files at once with a single command.

Performance & Scalability

✅ Multi-Client Support - Distributes traffic across multiple Telegram bots to avoid limits and increase throughput.
✅ Async Architecture - Built with aiohttp and asyncio for non-blocking, high-performance operations.
✅ MongoDB Integration - Ensures persistent and reliable data storage.

Security & Control

🔐 Token Authentication - Secure user access with a time-limited token system.
🛡️ Admin Controls - Full suite of commands for user and bot management.
👤 User Authentication - Require users to join a specific channel before they can use the bot.
✅ Channel/Group Support - Fully functional in private chats, groups, and channels.

Customization

🌍 Custom Domain - Serve files from your own domain for a professional look.
🔗 URL Shortening - Integrate with URL shortener services for clean, shareable links.
🎨 Custom Templates - Personalize messages sent by the bot to match your brand.
📈 Media Info Display - Shows file size, duration, and format details in the response message.

Configuration

Copy config_sample.env to config.env and fill in your values.

Essential Configuration

Optional Configuration

<details> <summary>Optional Configuration Details</summary>

</details>

Usage and Commands

Basic Usage

Start → Send /start to the bot.
Authenticate → Join required channels (if configured).
Upload → Send any media file.
Receive → Get a direct streaming and download link.
Share → Anyone can access the file via the link.

Commands Reference

User Commands

Admin Commands

<details> <summary><h4>BotFather Commands Setup</h4></summary>

start - Initialize bot
link - Generate direct link
dc - Get data center info
ping - Check bot status
about - Bot information
help - Show help guide
status - [Admin] System status
stats - [Admin] Usage statistics
broadcast - [Admin] Message all users
ban - [Admin] Ban user
unban - [Admin] Unban user
users - [Admin] User count
authorize - [Admin] Grant access
deauthorize - [Admin] Revoke access
listauth - [Admin] List authorized
log - [Admin] Send bot logs
restart - [Admin] Restart the bot
shell - [Admin] Execute shell command
speedtest - [Admin] Run network speed test