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.2 KiB

Raw Blame History

Memes Bot

A personal Telegram inline bot to store and search media (photos, GIFs, videos, voice, music, stickers, files) by keywords.

فارسی

Requirements

A server with Docker installed
A Telegram bot token from @BotFather

Setup

1. Create the bot in BotFather

/newbot → get your token
/setinline → enable inline mode, set a placeholder (e.g. Search memes...)

2. Find your Telegram user ID

You need your numeric Telegram user ID to whitelist yourself.

Easiest: forward any message to @userinfobot — it replies with your ID
Alternative: open Telegram Web, click your profile, the number in the URL is your ID
For multiple users: repeat for each person and separate IDs with commas

3. Clone and configure

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

Edit .env:

BOT_TOKEN=your_telegram_bot_token_here
ALLOWED_USERS=123456789,987654321

4. Run

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, voice message, music file, sticker, or any document, then type keywords when prompted (comma-separated or one per message), then /done.

Round video messages are stored as regular videos: Telegram has no inline result type for video notes, so keeping them as video is what makes them searchable.

Searching inline — in any chat type @yourbotusername keyword to search and send.

Telegram suggests these commands as you type /, with a short description beside each suggestion.

Commands

Command	Description
`/start`	Start the bot and show usage instructions
`/menu`	Show the available commands
`/list`	Show all saved media
`/edit [search]`	Select a meme and edit its keywords (admin only)
`/delete <id>`	Remove an entry (get ID from `/list`; admin only)
`/cancel`	Cancel current add operation

Moving to another server

The only files you need to transfer are:

.env
bot_db/media.db