Code Monkey home page Code Monkey logo

nazurin's Introduction

Nazurin

Codacy Badge

English | δΈ­ζ–‡

小さγͺ小さγͺθ³’ε°†, a Telegram bot that helps you collect ACG illustrations from various sites.

Architecture

architecture.png

Features

  • 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

Supported Sites

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/ βœ”
Twitter https://twitter.com/ βœ”
ArtStation https://www.artstation.com/ βœ”
Wallhaven https://wallhaven.cc/ βœ”
Bilibili Dynamics https://t.bilibili.com/ βœ”
Weibo https://weibo.com/ βœ”
DeviantArt https://www.deviantart.com/ βœ”
Lofter https://www.lofter.com/ βœ”
miHoYo BBS https://bbs.mihoyo.com/ βœ”

Supported Databases

Driver URL Usage Note
TinyDB https://tinydb.readthedocs.io/en/stable/index.html Wiki Default
Firestore https://firebase.google.com/products/firestore Wiki
MongoDB https://www.mongodb.com/ Wiki MongoDB Atlas supported
Cloudant https://www.ibm.com/cloud/cloudant Wiki

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.

Supported Storage

Name URL Usage Note
Local Set STORAGE = Local Default
Telegram https://telegram.org/ Wiki Added in v2
MEGA https://mega.nz/ Wiki
Google Drive https://drive.google.com/ Wiki
OneDrive https://onedrive.live.com/ Wiki

Configuration

For more information, see Wiki.

Deploy

For more deploy options, checkout Wiki.

Manual

Tips: You may comment out unused dependencies in requirements.txt before installation.

  1. Install dependencies: pip install -r requirements.txt
  2. Set the required environment variables or place them in .env file, you may refer to .env.example as an example
  3. Start the bot: python -m nazurin

Docker

  1. Configure the options in .env
  2. Run docker-compose up -d to use the lastet pre-built Docker images. (Alternatively, you may build the image yourself: docker-compose up -d --build)

Usage

Commands:

  • /ping - pong
  • /pixiv <id> - view pixiv artwork
  • /pixiv_download <id> - download pixiv artwork
  • /danbooru <id> - view danbooru post
  • /danbooru_download <id> - download danbooru post
  • /yandere <id> - view yandere post
  • /yandere_download <id> - download yandere post
  • /konachan <id> - view konachan post
  • /konachan_download <id> - download konachan post
  • /zerochan <id> - view zerochan post
  • /zerochan_download <id> - download zerochan post
  • /bookmark <id> - bookmark pixiv artwork
  • /clear_cache - clear download cache
  • /help - get help text

How to update your collection

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.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.