Telegram Image Board Bot written in Z Shell (zsh)

• Authorization
• Inline pools search
• Inline posts search
• Inline tags search
• Inline paging
• Inline autopaging
• Inline resuming
• Inline quick buttons
• Original file download
• Post information view
• Post tags view
• Post URL detection
• MD5 hash lookup
• SauceNAO reverse image search
• Inline shortcuts
• Inline shortcuts saving
• Inline shortcuts search

BusyBox is a hard-coded dependency and cannot be replaced with alternatives!

• zsh
• busybox
• curl
• jq
• recode

For distribution specific installation commands follow command-not-found.

• base64
• cut
• find
• grep
• ls
• sed
• sha1sum
• sleep
• tar
• tr

Usage: ./bot.zsh [options] [token]

For better performance, it is recommended to use a locally deployed Telegram Bot API server.

Options:
  -h            Show help information
  -a <addr>     Telegram Bot API address, default: api.telegram.org
  -o            Allow SauceNAO with unknown Telegram Bot API instance
  -l            Use local Telegram Bot API, address: 127.0.0.1:8081
  -r <num>      Inline results limit, max: 50, default: 10
  -g <num>      Shortcuts storage limit, max: 10000, default: 500
  -m <mode>     Cache mode, default: normal
  -t <secs>     Cache expiration time, max: 1000, default: 300 secs
  -s <secs>     Sleep duration time, max: 100, default: 10 secs
  -c            Do not clear cache automatically
  -q            Do not print logs
  -i <secs>     Telegram Bot API connetion timeout, max: 5, default: 5 secs
  -e <secs>     Image Boards API connetion timeout, max: 5, default: 5 secs
  -d <secs>     Head request connetion timeout, max: 5, default: 2 secs
  -f <secs>     Connrefused timeout, max: 2, default: none
  -n <addr>     Proxy server for Telegram Bot API
  -x <addr>     Proxy server for Image Boards/SauceNAO API
  -k <key>      SauceNAO API key for public use

Cache modes:
  none          No cache reuse
  normal        Reuse inline results and posts cache
  advanced      Extract posts cache from inline results

• [command] - Inline command
• [b] - Image Board
• [page] - Search page number
• [options] - Search options
• [name] - Search pool or tag name
• [tags] - Search tags
• [query] - Search query
• [id] - Post ID
• [md5] - MD5 hash
• [login] - Image Board login or username
• [key] - Image Board API key or password
• [snkey] - SauceNAO API key

• pools [b] [page] [options] [name] - Pools search
• posts [b] [page] [options] [tags] - Posts search
• tags [b] [page] [options] [name] - Tags search
• shorts [page] [options] [query] - Shortcuts search

• a - Enable autopaging (lpts)
• m - Show more metadata (p)
• p - Show gif/video as preview only (p)
• q - Add quick buttons (lpts)
• r - Reverse search order (s)
• w - Match full words only (s)

• help - Send help message
• original [b] [id/md5] - Get original file of post
• post [b] [id/md5] - Get information of post
• short [query] - Create inline shortcut
• donate - Send donation details

• /help - Send help message
• /authorize [b] [login] [key] - Authorize to Image Board
• /original [b] [id/md5] - Get original file of post
• /post [b] [id/md5] - Get information of post
• /hash [md5] - Get posts IDs by hash lookup
• /source [snkey] - Reverse search image
• /short [query] - Create inline shortcut
• /shorts - Manage saved shortcuts
• /ping - Measure bot latency
• /donate - Send donation details
• /export - Export all user data
• /stop - Remove all user data

• l - pools
• p - posts
• t - tags
• s - shorts

• p d 1 -a rating:g
• t d *genshin*
• original d 4507929
• short p d -mq ringouulu

• a - Safebooru
• d - Danbooru
• g - Gelbooru
• i - Idol Complex
• k - Konachan.com
• s - Sankaku Channel
• y - yande.re

If you want to support this bot development you can donate any amount of these cryptocurrencies