Visual NovelRPC docs
DiscordGitHub55Download

VNDB list & wishlist

Link your VNDB account to rate VNs, keep your VNDB list up to date as you read, and get a random pick from your wishlist.

All of this is optional. Covers and VNDB links work without an account; a token is only needed for things that touch your list.

Add your VNDB token

  1. On vndb.org, open your profile, then Edit → Applications and create a New token.
  2. Give it access to your list and permission to edit it. Without the edit permission, rating and sync won't work.
  3. Paste it in Settings → General → VNDB list → Personal token and click Test. It should say Connected as <your username>.

The token is like a password for your VNDB list. Don't share it. Note that a data export contains it.

Rate a VN

On a VN's page in the Library, choose a Rating. It's sent to your VNDB list right away. The VN must be linked to the right VNDB entry: if Confirm shows next to its VNDB id, check it's the right one and click it. If it's wrong, start the game and pick the right VN with Change VN / cover….

Sync your reading status

Turn on Sync reading status to my VNDB list. Then:

  • Statuses you set in the Library (Reading, Finished, Stalled, Dropped) are sent to your VNDB list. Reading is called Playing on VNDB.
  • VNs you start are marked Playing on VNDB, if they don't have a status there yet. Don't want that? Turn off Mark VNs as Playing on VNDB when I start them, just below.
  • A VN that gets a status leaves your VNDB wishlist: once you've started it, it's no longer something you wish to read.
  • Only VNs whose VNDB entry you picked or confirmed are synced, so a wrong match never lands on your list.

Bring your finished VNs into the Library

Read a lot before installing the app? With a token, turn on Add my finished VNs from VNDB to the Library in Settings → General → VNDB list. Every VN marked Finished on your list shows up in the Library, even if it isn't on this PC, with its cover, your rating and its finish date. New ones are added each time the app starts.

They say “From your VNDB list” instead of a time read, and have no Play button.
  • A VN already in your Library isn't added twice.
  • Remove one from the Library and it stays out, even at the next start.
  • Start one on your PC later and confirm its VNDB entry: it merges with the game by itself, keeping its status, rating and finish date.
  • Only Finished VNs are added, not those marked Playing, Stalled or Dropped.

Random pick from your wishlist

Can't choose what to read next? In the Library, click Random from wishlist. The app loads the VNs on your VNDB wishlist and shows one at random.

Each pick shows its year, VNDB rating and average length (~78h here), when VNDB knows them.

Another one (or Space) draws again; VNDB page opens it on vndb.org. The desktop mascot can also make a pick from its right-click menu.

Empty? Add VNs to your Wishlist on vndb.org (the wishlist label on your list), then come back.