https://github.com/sarisan/sekoohaka
Telegram Image Board Bot written in Z Shell (zsh)
https://github.com/sarisan/sekoohaka
booru bot danbooru gelbooru idol konachan safebooru sankaku saucenao telegram yandere
Last synced: 4 months ago
JSON representation
Telegram Image Board Bot written in Z Shell (zsh)
- Host: GitHub
- URL: https://github.com/sarisan/sekoohaka
- Owner: Sarisan
- License: apache-2.0
- Created: 2024-04-23T18:00:08.000Z (about 2 years ago)
- Default Branch: zsh
- Last Pushed: 2026-03-02T03:54:50.000Z (4 months ago)
- Last Synced: 2026-03-02T07:48:23.254Z (4 months ago)
- Topics: booru, bot, danbooru, gelbooru, idol, konachan, safebooru, sankaku, saucenao, telegram, yandere
- Language: Shell
- Homepage: https://t.me/SekoohakaBot
- Size: 607 KB
- Stars: 13
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Sekoohaka
Telegram Image Board Bot written in Z Shell (zsh)
Search posts, pools and tags on various booru-like Image Boards,
Authorize to expand limits and access private favorites,
View post information, tags, get original file,
Do MD5 hash lookup to find post by a hash,
Reverse search image with SauceNAO,
Create and save inline shortcuts
## Requirements
### Commands
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](https://command-not-found.com/).
### BusyBox functions
* base64
* cut
* find
* grep
* head
* ls
* sed
* sha1sum
* sleep
* tail
* tar
* tr
* wc
## Deployment
Usage: `./bot.zsh [options] [token]`
For better performance, it is recommended to use a locally deployed [Telegram Bot API](https://github.com/tdlib/telegram-bot-api) server.
### Available options
```
Options:
-h Show help information
-a 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 Inline results limit, max: 50, default: 10
-g Shortcuts storage limit, max: 10000, default: 500
-m Cache mode, default: normal
-t Cache expiration time, max: 1000, default: 300 secs
-s Sleep duration time, max: 100, default: 10 secs
-c Do not clear cache automatically
-q Do not print logs
-i Telegram Bot API connetion timeout, max: 5, default: 5 secs
-e Image Boards API connetion timeout, max: 5, default: 5 secs
-d Head request connetion timeout, max: 5, default: 2 secs
-f Connrefused timeout, max: 2, default: none
-n Proxy server for Telegram Bot API
-x Proxy server for Image Boards/SauceNAO API
-k 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
```
## Supported Image Boards
* [Safebooru](https://safebooru.donmai.us/)
* [Danbooru](https://danbooru.donmai.us/)
* [Gelbooru](https://gelbooru.com/)
* [Idol Complex](https://www.idolcomplex.com/)
* [Konachan.com](https://konachan.com/)
* [Sankaku Channel](https://www.sankakucomplex.com/)
* [yande.re](https://yande.re/)
## Donation
If you want to support this bot development you can donate any amount of these cryptocurrencies
| Currency | Address |
| :---: | :---: |
| BTC | `bc1qqr8yryvx43y6p3kg7y2cw32w6tv748el7k38ff` |
| ETH | `0x8993D744dF7183e112E2A4489991890f6a143104` |
| BNB | `0x8993D744dF7183e112E2A4489991890f6a143104` |
| TON | `UQBdoPQq3akozSLiWqt6x2Rizv0TrxHzRjczoztFN-LMCwGO` |