1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
# Sekoohaka
Telegram Image Board Bot written in Z Shell (zsh)
## Features
* 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
* Children IDs lookup
* MD5 hash lookup
* SauceNAO reverse image search
* Inline shortcuts
* Inline shortcuts saving
* Inline shortcuts search
## Requirements
### Commands
BusyBox is a hard-coded dependency and cannot be replaced with alternatives!
* zsh
* busybox
* curl
* jq
* recode
* xq
For distribution specific installation commands follow [command-not-found](https://command-not-found.com/).
### BusyBox functions
* base64
* cut
* find
* grep
* ls
* sed
* sort
* sha1sum
* sleep
* 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 <addr> Telegram Bot API address, default: api.telegram.org
-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: 100
-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 Clear cache automatically
-j Use threaded MD5 hash lookup
-q Do not print logs
-u Collect debug dumps
-i <secs> Telegram Bot API connetion timeout, max: 10, default: 10 secs
-e <secs> Image Boards API connetion timeout, max: 10, default: 5 secs
-d <secs> Head request connetion timeout, max: 10, 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 API
Cache modes:
none No cache reuse
normal Reuse inline results and posts cache
advanced Extract posts cache from inline results
```
## Usage
### Fields description
* `[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
### Inline search
* `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
### Search options
* `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)
### Inline commands
* `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
### Commands
* `/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
* `/parent [b] [id]` - Get children posts IDs
* `/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
### Inline aliases
* `l` - `pools`
* `p` - `posts`
* `t` - `tags`
* `s` - `shorts`
### Inline examples
* `p d 1 -a rating:g`
* `t d *genshin*`
* `original d 4507929`
* `short p d -mq ringouulu`
### Supported Image Boards
* `a` - [Safebooru](https://safebooru.donmai.us/)
* `d` - [Danbooru](https://danbooru.donmai.us/)
* `g` - [Gelbooru](https://gelbooru.com/)
* `i` - [Idol Complex](https://idol.sankakucomplex.com/)
* `k` - [Konachan.com](https://konachan.com/)
* `s` - [Sankaku Channel](https://chan.sankakucomplex.com/)
* `y` - [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` |
|
