What is LunaBox
LunaBox is a fast, beautiful, and feature-rich lightweight visual novel management tool. Beyond downloading, it helps you organize your game library, track playtime, and even analyse your habits with a built-in AI assistant.
Key features:
- Game management — Custom categorization and flexible metadata for your library
- Playtime tracking — Automatic session recording with multi-dimensional statistics and charts
- AI analysis — Built-in assistant that analyses your play habits and generates reports
- Cloud backup — S3 and OneDrive support for secure data sync
- Download integration — Handles archive downloads with automatic decompression, checksum verification, and resume support
Installing LunaBox
Download and install LunaBox from the official site: https://box.lunarain.site
Two Windows editions are currently available:
- Installer (setup): Recommended for most users. During installation, LunaBox will usually try to register the
lunabox://protocol automatically, so the download button should work out of the box. Data is stored in%APPDATA%\LunaBoxby default. - Portable: Ready to use after extraction, but you will usually need to register the
lunabox://protocol manually before first use. Data is stored in the program directory by default.
If you later move the portable folder, reinstall Windows, or find that the installer build can no longer launch LunaBox through the protocol, you can run the registration command again:
# Switch to the directory that contains lunacli and register the protocol
.\lunacli.exe --register-protocol
# If lunacli is already available in PATH, you can run it directly. The installation version will automatically handle the registration of environment variables
lunacli --register-protocol
You can also refer to the LunaBox documentation.
LunaBox currently supports Windows only. The LunaBox button will not appear on mobile devices.
Disabling or Enabling the LunaBox Button in Shionlib
The LunaBox download button is displayed by default. To disable it:
- Open Settings → Download (or go to
/user/settings/download) - Find the LunaBox section
- Uncheck Show LunaBox download button
Once disabled, the LunaBox icon button will no longer appear next to the Aria2 and normal download buttons on every file row in the download panel.
Using LunaBox to Download
- On any game page, click Download to open the download panel
- Find the resource and file you want
- Click the moon icon button to push the download to LunaBox
- If a Turnstile verification is required, complete it in the popup — LunaBox will receive the task automatically once verified
- Switch to LunaBox — the download will have started
LunaBox receives the following information with each push:
| Field | Value |
|---|---|
| Download URL | Signed, time-limited direct link |
| File name | Original file name from Shionlib |
| Archive format | Auto-detected from the file extension |
| File size | Exact byte count for validation |
| Checksum | SHA-256 or BLAKE3 hash for integrity check |
| Game title | Japanese title of the game |
| Metadata source | Bangumi (for library matching) |
Troubleshooting
The LunaBox button does nothing when clicked
First check whether the lunabox:// protocol is registered correctly:
- Installer build: it is usually registered automatically; if it stops working, re-register the protocol as described above, or reinstall LunaBox
- Portable build: launch LunaBox first, then run
.\lunacli.exe --register-protocolin the directory that contains the file
After running the command, restart LunaBox and try again.
The download does not appear in LunaBox
- Check whether your browser or OS is blocking the
lunabox://protocol - Check whether a confirmation dialog asking to open LunaBox was ignored
Can it download if LunaBox was not opened in advance
Yes. As long as the protocol is registered, clicking the LunaBox button in Shionlib will launch LunaBox automatically and pass the current download request to it.
Turnstile verification does not complete
The Turnstile popup closes automatically after you solve it. If the download still does not start, click the moon icon again — the signed link is cached for your session so you will not need to verify again.