Files

T

goyban efc2be5f8a Support audio, documents, stickers and video notes

Completes TODO #6. The bot accepted photo, animation, video, voice and
sticker; music files, documents and round videos were silently dropped.

- Replace the five near-identical media handlers with one dispatch table.
  Animations are matched before documents because Telegram populates
  both fields for a GIF, so the old ordering would have filed every GIF
  as a document once document support existed.
- Store video notes as "video". Telegram has no cached inline result for
  video notes, so this is what keeps round videos searchable; it costs
  the round presentation on playback.
- Build inline results from a table keyed by media_type, and cover audio
  and document. A test asserts every storable type has a builder, so a
  new media type cannot be added without a way to return it.
- Reuse one MEDIA_FILTER for both the idle and mid-keyword handlers;
  the second list had already drifted from the first.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-01 21:25:11 +00:00

2.4 KiB

Raw Blame History

Memes Bot

ربات شخصی تلگرام برای ذخیره و جستجوی میم (عکس، گیف، ویدیو، صدا، موزیک، استیکر، فایل) با کلیدواژه.

English

پیش‌نیازها

یک سرور با Docker نصب‌شده
توکن ربات تلگرام از @BotFather

راه‌اندازی

۱. ساخت ربات در BotFather

/newbot ← توکن بگیرید
/setinline ← حالت اینلاین را فعال کنید (مثلاً: جستجوی میم...)

۲. پیدا کردن شناسه تلگرام

برای وایت‌لیست کردن خودتان به ID عددی نیاز دارید.

ساده‌ترین روش: یک پیام به @userinfobot فوروارد کنید — شناسه شما را برمی‌گرداند
روش دیگر: تلگرام وب را باز کنید، روی پروفایل کلیک کنید، عدد داخل URL شناسه شماست
برای چند کاربر: ID هر نفر را با کاما جدا کنید

۳. کلون و تنظیم

git clone https://git.goyban.com/goyban/memes_bot
cd memes_bot
cp .env.example .env

فایل .env را ویرایش کنید:

BOT_TOKEN=توکن_ربات_شما
ALLOWED_USERS=123456789,987654321

۴. اجرا

docker compose up -d --build

دیتابیس در مسیر ./bot_db/media.db ذخیره می‌شود.

نحوه استفاده

افزودن میم — یک عکس، گیف، ویدیو، صدا، موزیک، استیکر یا هر فایلی برای ربات بفرستید. ربات از شما کلیدواژه می‌خواهد. کلیدواژه‌ها را یکی‌یکی یا با کاما جدا بفرستید، سپس /done بزنید.

جستجوی اینلاین — در هر چتی بنویسید @نام_ربات کلیدواژه تا نتایج نمایش داده شود.

دستورات

دستور	توضیح
`/list`	نمایش همه رسانه‌های ذخیره‌شده
`/delete <id>`	حذف یک مورد (ID را از `/list` بگیرید)
`/cancel`	لغو عملیات جاری

انتقال به سرور دیگر

فقط کافی است این دو فایل را منتقل کنید:

.env
bot_db/media.db