tg_source_bot/README.md

🛡️ Secure File Bot (aiogram)

A private Telegram file storage bot built with aiogram 3.x.
It securely accepts messages, pictures, videos, and documents only from a specific Telegram user,
then saves them to a local storage folder.

You can search, retrieve, delete, and summarize your stored files — all via Telegram commands.

---

✨ Features

✅ Access Control — Only a pre-defined user_id can use the bot.
✅ Auto Storage — Automatically saves text, pictures, videos, and documents locally.
✅ Supports All Formats — JPG, PNG, WEBP, MP4, AVI, MOV, and more.
✅ Search & Retrieve — Quickly find and fetch any stored file.
✅ Delete Command — Remove specific files from storage.
✅ Overview Command — View all saved files, sizes, and timestamps.
✅ Future-Ready — Easily extendable for OpenAI or 3rd-party API integration.

---

🧰 Installation

1. Clone this repo

git clone https://github.com/yourusername/secure-file-bot.git
cd secure-file-bot

2. Install dependencies

pip install aiogram==3.13

3. Set up configuration

Open the Python script (secure_file_bot_aiogram.py) and update these constants:

BOT_TOKEN = "YOUR_BOT_TOKEN_HERE"      # Get it from @BotFather
AUTHORIZED_USER_ID = 123456789         # Your personal Telegram user ID
STORAGE_DIR = "local_storage"          # Folder where files are saved

🚀 Run the Bot

python secure_file_bot_aiogram.py

Once running, open your bot in Telegram and type:

/start

💬 Commands

Command Description

Command	Description
/start	Initialize bot and create storage folder
/overview	Show summary of all stored files
/search <keyword>	Search for a file by name
/get <number>	Retrieve a file from search results
/delete <filename>	Delete matching file(s)
(Send any text, image, or video)	Automatically saved to local storage

🧠 How It Works

• When you send text → stored as .txt
• When you send a picture → auto-detects MIME type (JPG, PNG, WEBP, etc.)
• When you send a video → auto-detects format (MP4, AVI, MOV, etc.)
• When you send a document → saved using its original name and MIME extension
• Everything is organized in your local_storage/ folder

🧩 Example Folder Structure

secure_file_bot_aiogram/
├── secure_file_bot_aiogram.py
├── requirements.txt
├── README.md
└── local_storage/
    ├── 20251103_140501.txt
    ├── 20251103_141012.jpg
    ├── 20251103_141223.mp4
    └── ...