README.md

---
title: testbot
emoji: 🎬
colorFrom: red
colorTo: yellow
sdk: docker
app_port: 7860
pinned: false
---

# 🔥 ANGRY BIRD File Serve Bot (Premium Edition) 🔥

A premium, high-speed **Telegram File Search and Direct Browser Download** bot powered by **FastAPI**, **Pyrogram**, and **Neon PostgreSQL**. Designed for seamless 24/7 deployment on **HuggingFace Spaces** (Docker) and **Render**.

---

## 🌟 Core & Premium Features

### 💎 Premium High-Speed Streaming Gateway
*   **🌐 Direct Browser Streaming**: High-speed browser file downloading directly from Telegram CDNs using custom-engineered asynchronous chunk streaming.
*   **⚡ Concurrency Optimized (100 Slots)**: Supports up to **100 simultaneous parallel downloads/streams** without any queuing or delay bottlenecks, utilizing `workers=100` parallel client connections.
*   **🚀 Practically 0 MB Server Overhead**: Streams block-by-block using Pyrogram's `client.stream_media(...)` async generator, avoiding local file caching and RAM out-of-memory (OOM) failures entirely.
*   **🗑️ Auto-Clean Token Verification**: Automatically cleans up authorization alerts, expiry errors, and incoming user query messages after a 10-second delay, ensuring clean private chats.
*   **❓ Dynamic Help & Guide Integrations**: Renders a dynamic administrative control setting button (`how_to_download` guide URL) across `/start` keyboards.

### 🔍 Advanced Database Search Engine
*   **🔥 Weekly Trending Tracker (`/trending`)**: Automatically monitors and tracks movie search query frequencies over a 7-day rolling cycle, presenting the top 10 most popular movies directly to users on start keyboards or inline buttons.
*   **🆕 Newly Uploaded Monitor (`/newuploads`)**: Displays a real-time list of the 25 most recently indexed movies/files, making it easy for users to check recent releases instantly.
*   **📈 Trigram pg_trgm Fuzzy Search**: Implements fuzzy title-matching leveraging PostgreSQL GIN trigram indexes to suggest and correct spelling mistakes.
*   **🎯 Precise Mode Search Option**: Toggleable precise-matching mode to target exact word hits or perform general query containing searches.
*   **📁 Multiple File Formats Supported**: Fully indexes and handles Documents, Video files, and Audio file formats with complete metadata logging.
*   **🔀 Multi-Format Result Output**: Dynamically outputs search query results in button layouts, list structures, or hyperlink lists.

### ⚙️ Channel Indexing & Operations
*   **🔄 Automated Live Indexing**: Real-time listening and automatic indexing of files uploaded directly to DB channels.
*   **📦 Manual Indexing (`/index`)**: Forward-based administrative channel scanning to easily batch-import files into database records. Works based on original file captions to prevent duplicate quality skip issues!
*   **🗑️ Dynamic Database Deletion**: Quick inline administrative file deletions (`/delete`) directly inside chat threads.
*   **⏳ Auto-Delete Schedule**: Automatic scheduled file purge settings to clear files after configured time thresholds.

### 🧹 Bulk Delete Mode
*   **Smart Bulk Deleting**: Standalone `/delete` command turns on a powerful state-based bulk delete mode. Forward multiple files at once, and the bot will automatically delete them all from the database, deactivated with `/done`.

### 🛡️ Administration & Controls
*   **🛡️ Multi-Channel Force Subscribe**: Blocks all search queries, keyboard commands, and downloads until users join all configured update channels. Supports a comma-separated list of public/private channels in settings.
*   **🔗 Dynamic Invite Link Generation**: Automatically resolves usernames (even without `@` prefix) or creates private invite links for each configured channel dynamically.
*   *   **🔄 Instant Resumption Handshake**: Saves blocked queries in the database and automatically executes them once the user joins and clicks "Try Again". If a token shortener is enabled, the query is passed seamlessly to the token system and executed automatically upon returning from the browser via `/start tok_xxxx`.
*   *   **🎛️ Spam & Double-Click Protection**: Instantly removes verification buttons when clicked to prevent duplicate execution, and edits prompt messages in-place with popup alerts to prevent user chat spam.
*   *   **📅 Filename Release Years**: Automatically extracts movie release years from filenames (e.g. `1900-2030`) and appends them to search list buttons (e.g., `Odyssey (2026)`) for a cleaner UX.
*   **🏷️ Custom File Captioning**: Setup custom headers/captions (like adding usernames or watermarks) to all dispatched files.
*   **⛔ Member Ban/Unban System**: Block unwanted users instantly using `/ban` and `/unban` command strings.
*   **📢 Massive Broadcast system**: Send custom formatted alerts or messages globally to all registered bot users concurrently.
*   **📊 Live Server Stats & Logs**: Get real-time stats and runtime log dumps directly inside the administrator's chat.

---

## 📂 Codebase & Setup

For full instructions, file structures, and advanced procedures:
*   📖 Refer to the comprehensive deployment manuals at:
    *   [documentation/render_deployment_guide.md](file:///d:/Work/AngryBird-main/documentation/render_deployment_guide.md) (For Render and Local setups)

### Quick Local Run

1.  **Activate environment & install dependencies**:
    ```bash
    python -m venv .venv
    .venv\Scripts\Activate.ps1   # Windows
    source .venv/bin/activate    # Linux/macOS
    pip install -r requirements.txt
    ```

2.  **Add environment variables** to a local `.env` file (API_ID, API_HASH, BOT_TOKEN, DB_URL, OWNER_ID, DB_CHANNELS, etc.).

3.  **Launch the bot**:
    ```bash
    python -m mfinder
    ```

---

## 📜 License & Ownership

This software, codebase, and its implementations are **fully owned, managed, and licensed** by:
*   👤 **Angry Bird** (Primary Maintainer: [@ANGRY_BIRD22_bot](https://t.me/ANGRY_BIRD22_bot))
*   ⚡ **Team FireBolt**

All rights reserved. Unauthorized redistribution or copying of these custom features is strictly prohibited.