Visual NovelRPC docs
DiscordGitHub55Download

All settings

Every option of the Settings page, with its default. Changes are saved as soon as you make them.

Settings has six tabs: General, Presence, Theme (see Themes), Never detect, Advanced and Beta. At the top, Join the Discord opens the app's Discord server. At the bottom: the app's version and a Check for updates button.

There's no Save button: a switch, a field or a path applies right away. Title rules are the only exception: they have their own Save rules button.

General

Language

The app's language: 7 are available, or the same as Windows. The app reloads when you change it.

Covers & matching

SettingDefaultWhat it does
Allow NSFW-flagged coversOffOff: flagged covers are blurred in the app and replaced by the fallback image on Discord.
Use Steam library namesOnUses the Steam name of games installed through Steam, for better VNDB matches.

VNDB list

SettingDefaultWhat it does
Personal tokenEmptyYour VNDB token, for rating, sync and the wishlist. How to get one.
Sync reading status to my VNDB listOffSends the statuses you set in the Library to your VNDB list. A VN you start reading leaves your wishlist.
Mark VNs as Playing on VNDB when I start themOnShown when the option above is on. Only when the VN has no status on your list yet.
Add my finished VNs from VNDB to the LibraryOffShown once you have a token. Even VNs that aren't on this PC. Details.

Screenshots

SettingDefaultWhat it does
Capture keyPrint ScreenWorks only while the game is in front.
Capture sound30 %Shutter sound volume (Off at 0). ▶ plays it.
FolderPictures\Shiori RPCEach VN gets its own subfolder.

Japanese locale

SettingDefaultWhat it does
Locale Emulator (LEProc.exe)Not setPath to Locale Emulator.
NTLEA (ntleas.exe)Not setPath to NTLEA.

See Japanese locale.

App

SettingDefaultWhat it does
Start minimized to the trayOffStarts without showing the window.
Launch when Windows startsOffStarts the app when you log in to Windows. Still works if you move the .exe.
Check for updates at launchOnOffers new GitHub releases when the app starts.
What's new—Shows the notes of the last few releases.

Desktop mascot

Since 2.1, the mascot settings are on their own Mascots page, in the sidebar: see Desktop mascot.

Your data

Export… and Import…: see Your data & backups.

Presence

SettingDefaultWhat it does
Language on DiscordSame as the appThe language of your status, whatever the app's language.
Title on DiscordRomanizedRomanized or Original. VNs with no original title on VNDB keep the romanized one.
Show where you are in the storyOnThe “Reading・Chapter 1” line.
Show total time readOnThe “Total read: 3h 40m” line.
Show how far you areOffAdds “· 78%” to the time read, compared with the average length on VNDB.
Show elapsed timeOnThe timer since you started this session.
Clear presence when the VN closesOnYour status disappears when you quit the game.
Add a “View on VNDB” buttonOnA button on your status linking to the VN.
Go idle when the VN isn't the active windowOffClears your status and stops the timers while the game is in the background.
Seconds in the background before going idle60How long before idle kicks in. Shown when the option above is on.

Below these options, Your own layout (beta) lets you write your status yourself: see Discord status. While it's on, the options that set the lines of your status are greyed out.

Never detect

Programs that are never detected as a visual novel. Their games are also hidden from the Library. Type a program name (e.g. osu!.exe) and click Add; the × on an entry (Detect it again) removes it. Not a VN on the Now reading page adds to this list.

By default it contains osu!.exe, Medal.exe and Riot Client.exe. Browsers, Discord, Steam, OBS, code editors, terminals and everything Windows itself runs are always ignored, whatever the list says. So are the launchers, config tools and uninstallers that come with games.

Advanced

Only needed if something doesn't work as expected.

SettingDefaultWhat it does
Application IDThe app's ownThe Discord application your status is shown through. Test checks it. Use your own.
SettingDefaultWhat it does
Min. seconds between presence updates5The status is never sent to Discord more often than this.
Fallback Discord asset keyvn_coverThe image Discord shows when there's no cover to show: an NSFW cover, Private mode, or no cover found.

Title rules

Extra rules to read chapters and routes from a window title: see Chapters & routes. They have their own Save rules button.

Beta

Features being tried out. They may change or go away.

SettingDefaultWhat it does
Description and characters on a VN's pageOnFrom VNDB.
Search with Ctrl+KOnFind a VN or a page from anywhere.
Covers lift when hoveredOnA small animation in the Library.
Compact sidebarOffIcons only. The button at the bottom of the sidebar switches it too.
Keyboard shortcutsOn1 to 6 switch pages, Alt+← goes back.

Settings are stored in %APPDATA%\moe.lenn.shiori\config.yaml. See Your data.