Initial commit — personal Telegram meme bot with inline search

2026-04-24 17:49:22 +00:00
commit c832350300
9 changed files with 500 additions and 0 deletions
@@ -0,0 +1,133 @@
+# Memes Bot
+
+A personal Telegram inline bot to store and search media (photos, GIFs, videos, voice) by keywords.
+
+---
+
+## English
+
+### Requirements
+
+- A server with [Docker](https://docs.docker.com/engine/install/) installed
+- A Telegram bot token from [@BotFather](https://t.me/BotFather)
+
+### Setup
+
+**1. Create the bot in BotFather**
+- `/newbot` → get your token
+- `/setinline` → enable inline mode, set a placeholder (e.g. `Search memes...`)
+
+**2. Get your Telegram user ID**
+
+Send a message to [@userinfobot](https://t.me/userinfobot) to find your numeric user ID.
+
+**3. Clone and configure**
+
+```bash
+git clone https://git.goyban.space/goyban/memes_bot
+cd memes_bot
+cp .env.example .env
+```
+
+Edit `.env`:
+
+```env
+BOT_TOKEN=your_telegram_bot_token_here
+ALLOWED_USERS=123456789
+```
+
+`ALLOWED_USERS` is a comma-separated list of Telegram user IDs allowed to use the bot.
+
+**4. Run**
+
+```bash
+docker compose up -d --build
+```
+
+The database will be saved in `./bot_db/media.db`.
+
+### Usage
+
+**Adding media** — send the bot a photo, GIF, video, or voice message, then type keywords when prompted (comma-separated or one per message), then `/done`.
+
+**Searching inline** — in any chat type `@yourbotusername keyword` to search and send.
+
+**Commands**
+
+| Command | Description |
+|---|---|
+| `/list` | Show all saved media |
+| `/delete <id>` | Remove an entry (get ID from `/list`) |
+| `/cancel` | Cancel current add operation |
+
+### Moving to another server
+
+The only files you need to transfer are:
+
+- `.env`
+- `bot_db/media.db`
+
+---
+
+## فارسی
+
+### پیش‌نیازها
+
+- یک سرور با [Docker](https://docs.docker.com/engine/install/) نصب‌شده
+- توکن ربات تلگرام از [@BotFather](https://t.me/BotFather)
+
+### راه‌اندازی
+
+**۱. ساخت ربات در BotFather**
+- `/newbot` ← توکن بگیرید
+- `/setinline` ← حالت اینلاین را فعال کنید (مثلاً: `جستجوی میم...`)
+
+**۲. دریافت شناسه تلگرام**
+
+یک پیام به [@userinfobot](https://t.me/userinfobot) بفرستید تا ID عددی‌تان را بگیرید.
+
+**۳. کلون و تنظیم**
+
+```bash
+git clone https://git.goyban.space/goyban/memes_bot
+cd memes_bot
+cp .env.example .env
+```
+
+فایل `.env` را ویرایش کنید:
+
+```env
+BOT_TOKEN=توکن_ربات_شما
+ALLOWED_USERS=123456789
+```
+
+`ALLOWED_USERS` لیستی از شناسه‌های تلگرامی است که اجازه استفاده دارند (با کاما جدا کنید).
+
+**۴. اجرا**
+
+```bash
+docker compose up -d --build
+```
+
+دیتابیس در مسیر `./bot_db/media.db` ذخیره می‌شود.
+
+### نحوه استفاده
+
+**افزودن میم** — یک عکس، گیف، ویدیو یا صدا برای ربات بفرستید. ربات از شما کلیدواژه می‌خواهد. کلیدواژه‌ها را یکی‌یکی یا با کاما جدا بفرستید، سپس `/done` بزنید.
+
+**جستجوی اینلاین** — در هر چتی بنویسید `@نام_ربات کلیدواژه` تا نتایج نمایش داده شود.
+
+**دستورات**
+
+| دستور | توضیح |
+|---|---|
+| `/list` | نمایش همه رسانه‌های ذخیره‌شده |
+| `/delete <id>` | حذف یک مورد (ID را از `/list` بگیرید) |
+| `/cancel` | لغو عملیات جاری |
+
+### انتقال به سرور دیگر
+
+فقط کافی است این دو فایل را منتقل کنید:
+
+- `.env`
+- `bot_db/media.db`