Skip to content

Saramanda9988/LunaBox

Repository files navigation

LunaBox Logo

LunaBox

Lightweight, fast, and feature-rich visual novel management and game statistics tool

中文 | English | 日本語

Go Wails React

✨ Features

  • Game category management - Organize your library with custom categories
  • Playtime tracking - Automatically track session time when launching games
  • Small binary footprint - Built with Wails, no full browser runtime bundled
  • Multi-dimensional statistics - View play data by day/week/month/year and export shareable stat cards
  • AI insights - Generate personalized and fun reports based on your gameplay data
  • Convenient data import - Import from PotatoVN, Playnite, and Vnite; supports folder batch import and drag-and-drop
  • Multi-channel backup - Local backup, AWS S3, Qiniu, Alibaba Cloud OSS (S3-compatible), and OneDrive backup
  • CLI Mode - Support for managing, launching, and backing up games, and modifying program data via command line
  • Privacy and security - All sensitive data is stored locally

Screenshots

Click to view more custom background styles

Home

Library

Game Detail

Click to view stat export poster templates

Minimal

Future Retro

Journal Style

Additional in-app screenshots (located in the screenshot/ directory):

Home

Library

Game Detail

🛠️ Tech Stack

Layer Technology
Framework Wails v2
Backend Go 1.24
Frontend React 18 + TypeScript
Database DuckDB
Build Tool Vite
Styling UnoCSS
Routing TanStack Router
State Management Zustand
Charts Chart.js + react-chartjs-2

📦 Installation

Download from Releases

Go to the Releases page and download the latest installer.

Build from source

Prerequisites

# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest

Build steps

# Clone project
git clone https://github.com/Saramanda9988/lunabox.git
cd lunabox

# Install frontend dependencies
cd frontend && pnpm install && cd ..

# Run in development mode
wails dev

# Build production version
wails build

# Build locally using script (Windows)
.\scripts\build.bat all 1.0.0-beta

🤝 Contributing

Issues and Pull Requests are welcome.

🗺️ Roadmap

  • Improve logging system
  • Support importing data from ReinaManager
  • Self-hosted Docker server
  • IM platform bot plugin
  • Multi-device synchronization
  • Gallery feature
  • Expose MCP and provide link-based game launch capability for AI
  • "What to play next" recommendation feature
  • Support Linux/macOS platform
  • Support Korean/Traditional Chinese and other languages

😀 Open Source Inspired by Open Source

Inspiration:

  • PotatoVN - Galgame 管理工具
  • ReinaManager - 一款轻量化的galgame和视觉小说管理工具
  • Playnite - An open source video game library manager with one simple goal: to provide a unified interface for all of your games
  • Vnite - A unified platform to organize your game collection, track gameplay, with real-time cloud sync across devices and detailed gameplay reports

🙏 Acknowledgements

Game metadata APIs:

  • Bangumi - Bangumi番组计划
  • VNDB - The Visual Novel Database
  • 月幕gal - 请感受这绝妙的文艺体裁
  • 萌娘百科 - 万物皆可萌的百科全书
  • Steam - The world's largest digital game distribution platform

Archive extraction support:

  • 7-Zip - A free and open-source file archiver, a utility used to place groups of files within compressed containers known as "archives".

📄 License

This project is licensed under AGPL v3.

About

Lightweight, fast, and feature-rich visual novel management and game statistics tool

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors