Visual NovelRPC docs
DiscordGitHub39Download

Troubleshooting

The usual problems, and how to fix them.

Discord

Nothing shows on my Discord profile

  • The Discord desktop app must be running on the same PC (not Discord in a browser). The Discord dot in the app turns green once it's connected.
  • In Discord: User Settings → Activity Privacy → Share your detected activities with others must be on.
  • Check the Discord preview on the Now reading page. If nothing is shared, it says why: paused, idle in the background, or the game's privacy is set to Off.
  • If you set your own Application ID, click Test next to it in Settings. If it fails, paste back the app's default ID, 1466261523889393892.
  • Started Discord after the app? Give it a few seconds: the app reconnects by itself.

My status shows a generic image instead of the cover

That's the fallback image. It's used when there's no cover to show: no match on VNDB, an NSFW-flagged cover (not sent unless you allow it), or the game set to Private. Pick a VNDB entry or an image link in Change VN / cover…. See Covers.

My status stays after I close the game

Turn on Clear presence when the VN closes in Settings → General → Presence.

I don't see the “View on VNDB” button on my profile

That's normal: Discord doesn't show your own status buttons to you. Your friends see it.

Detection

My VN isn't detected

Its engine probably isn't one the app knows. Switch the Detection bar to Manual and pick the game's window (Refresh if it isn't in the list). Check also that its .exe isn't in Settings → Never detect.

Another program is detected as a VN

Click Not a VN in the Detection bar, next to the detected program. It's added to Never detect and won't be detected again.

Wrong VN, wrong cover or wrong VNDB page

The VNDB search picked the wrong match. Click ? on the Now reading card, or open Change VN / cover… (Now reading) or Change cover & privacy… (the VN's page in the Library), search the right title (the Japanese title often works best) and click Use. Turning on Use Steam library names helps for Steam games.

No chapter or route is shown

The game doesn't put it in its window title, so there's nothing to read. Type it yourself with + Route / chapter on the Now reading page. If it does but in an unusual format, add a title rule.

Time read

Time keeps counting while the game is in the background

Turn on Go idle when the VN isn't the active window in Settings. Already counted too much? Use Edit total read on the VN's page in the Library.

Updating to 2.0

My Library is empty after updating from 1.x

Version 2.0 copies your 1.x data from %APPDATA%\VisualNovelRPC\ on its first launch. If that folder was moved or emptied, there's nothing to copy. If you have a backup .zip from 1.x, import it with Settings → General → Your data → Import…. See Your data.

I can't find the Save button

There isn't one anymore: in 2.0, settings apply as soon as you change them.

Games

The game shows garbled text or doesn't start

It needs a Japanese locale. See Japanese locale.

Print Screen doesn't take a screenshot

The key only works while the game's window is in front, and only when a VN is detected. Check the key in Settings → General → Screenshots → Capture key (it may have been turned off with Backspace).

Still stuck?

Ask on the Discord server, or use Report a bug on the app's What's new page: it opens a GitHub issue already filled with your version. Mention the VN's name and its engine (shown under the title on the Now reading page).

Join the community

Questions, bug reports, ideas, and soon translations of the app into more languages: it all happens on the Discord server.