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 pushing 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.
Disabling or Enabling LunaBox in Shionlib
LunaBox appears in the push menu by default. To disable it:
- Open Settings → Download (or go to
/user/settings/download) - Find the LunaBox section
- Turn off Show LunaBox in the push menu
Once disabled, the LunaBox entry no longer appears in the push menu of 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 paper plane icon button on the right of the file row to open the push menu
- Choose LunaBox to push the download to it
- 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
Nothing happens after choosing LunaBox in the push menu
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, choosing LunaBox in the Shionlib push menu 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, open the push menu and choose LunaBox again — the signed link is cached for your session so you will not need to verify again.