ε°γγͺε°γγͺθ³’ε°, a Telegram bot that helps you collect ACG illustrations from various sites.
- View/Download artwork from various sites
- Add images to your collection via Telegram
- Store your collection in Telegram channels
- Store images on multiple types of storage
- Store image metadata in multiple types of database
| Name | URL | Commands | Collection |
|---|---|---|---|
| Pixiv | https://www.pixiv.net/ | β | β |
| Danbooru | https://danbooru.donmai.us/ | β | β |
| Safebooru | https://safebooru.donmai.us/ | β | |
| yandere | https://yande.re/ | β | β |
| Konachan | https://konachan.com/ | β | β |
| Lolibooru | https://lolibooru.moe/ | β | |
| Zerochan | https://www.zerochan.net/ | β | β |
| Gelbooru | https://gelbooru.com/ | β | |
| https://twitter.com/ | β | β | |
| ArtStation | https://www.artstation.com/ | β | |
| Wallhaven | https://wallhaven.cc/ | β | |
| Bilibili Dynamics | https://t.bilibili.com/ | β | |
| https://weibo.com/ | β | ||
| DeviantArt | https://www.deviantart.com/ | β | |
| Lofter | https://www.lofter.com/ | β | |
| Kemono.party | https://kemono.party/ | β | |
| Bluesky | https://bsky.app/ | β |
| Driver | Usage | Config Value | Note |
|---|---|---|---|
| TinyDB | TinyDB | Local |
Default |
| Firestore | Firestore | Firebase |
|
| MongoDB | MongoDB | Mongo |
MongoDB Atlas supported |
| Cloudant | Cloudant | Cloudant |
You can also implement your own database driver by creating a file under database folder, and set this option to the name of driver class.
| Name | Usage | Config Value | Note |
|---|---|---|---|
| Local | Local | Local |
Default |
| Telegram | Telegram | Telegram |
Added in v2 |
| MEGA | MEGA | Mega |
|
| Google Drive | Google Drive | GoogleDrive |
|
| OneDrive | OneDrive | OneDrive |
|
| S3 | S3 | S3 |
For more information, see Documentation.
For more deploy options, checkout Documentation.
- Install uv
- Create virtual environment and install dependencies:
uv sync - Set the required environment variables or place them in
.envfile, you may refer to.env.exampleas an example - Start the bot:
uv run nazurinorpython -m nazurin
- Configure the options in
.env - Run
docker-compose up -dto use the lastet pre-built Docker images. (Alternatively, you may build the image yourself:docker-compose up -d --build)
Use /help command to get a list of available commands or help for a specific command, use /set_commands to set bot commands in command menu.
Some system commands are listed below:
/clear_cacheβ Clear cache/help [COMMAND]β Get help of all commands or a specific command/pingβ Pong/set_commandsβ Set commands/startβ Get help
Send the bot a message with a link of supported sites, this message will be forwarded to GALLERY channel, the bot will then download the original images from the site, send the files to ALBUM channel, and finally store to your custom destinations.
Tips: On mobile you can use the share button in apps, as long as the final message contains a link.