Risa

Risa is an nHentai discord bot that will help you browse and download your favorite doujin inside your own discord server.

Hosting

Manual Hosting

To manual host Risa, just simply go into the config folder and edit the config.txt by replacing YourDiscordBotTokenHere with your discord app token, then change the file extension from .txt to .json, and execute risa_main.py.

Heroku Hosting

Risa is now host-ready for heroku! To host, just simply add your token as a config var
to your heroku app with the name BOT_TOKEN.

Commands

Read Command
Usage

!read <popular/newest/random/id>

  • returns a message/paginated message based on id or keyword in the input.
  • aliases: !r
Examples
  • !read popular
    returns a paginated message containing popular uploads.
    aliases: p, pop

  • !read newest
    returns a paginated message containing newest uploads.
    aliases: n, new

  • !read random
    returns a message containing the doujin with random id.
    aliases: rand

  • !read 177013
    returns a message containing the doujin with id of "177013".

Search Command
Usage

!search <query>

  • Returns a paginated message containing all matches on the query. Uses the same query system on the nh website. Note: there should be no spaces between colons, use double quotes for accuracy on tag name, and use dash line to avoid a tag. See the nh website guide here.
  • aliases: !s
Examples
  • !search Madoka Higuchi
    returns all matching doujins with name "Madoka Higuchi".

  • !search parody:Bang Dream
    returns all matching doujins with a parody name "Bang Dream".

  • !search tag:mind break characters:Lizbeth
    returns all matching doujins with tag name "mind break" and character name "Lizbeth".

  • !search artists:"artistname" -tag:"tentacles"
    returns only the matching doujins with artist name "artistname" but not with tag "tentacles".

Download Command
Usage

!download <id>

  • returns a message containing the download link of the doujin on the given id.
  • aliases: !dl
Examples
  • !download 367361
    returns a message containing the download link of the doujin with id of "367361".

Changelogs

  • Added footers.
  • Added aliases.
  • Added language and page info in paginated messages.
  • Added case insensitivity on commands.
  • Added amount of favorites

GitHub

https://github.com/arkhon7/risa-bot