Luna Translator

📖 Overview

LunaTranslator is an open-source GalGame / document real-time translator. Configure BeeHears as an OpenAI-compatible LLM provider to power translation with your models.

⚙️ Connect to BeeHears

BeeHears is a New API–compatible relay. In most apps, fill in the three fields below using a token from the BeeHears console:

📚 Setup guide

In the BeeHears

console's System Settings -> Chat Settings, you can add the following shortcut option for one-click population into

LunaTranslator from the Token Management page:

LunaTranslator

is an open-source and free visual novel (GalGame) translator, dedicated to providing a native-level visual novel gaming experience.

• Project Address: https://github.com/HIllya51/LunaTranslator
• Project Documentation: https://docs.lunatranslator.org/en/README.html

Feature Support

• HOOK Primarily uses HOOK to extract game text, adapting to almost all common and niche visual novels.

• In-game Translation For some games, translation can be directly embedded into the game for an immersive experience.

• HOOK Emulator For most games on NS/PSP/PSV/PS2, HOOK emulator support allows direct reading of game text.

• OCR Built-in high-precision OCR models, and supports many other online & offline OCR engines for flexible reading of any text.

• Rich Translation Interfaces Supports almost all translation engines, including large language model translation, offline translation, etc.

• Language Learning Supports Japanese word segmentation and kana furigana, AnkiConnect, and Yomitan plugin.

• Speech Synthesis Supports a large number of online & offline speech synthesis engines.

• Speech Recognition On Windows 10 and Windows 11, Windows Speech Recognition can be used.

Installation Method

Download and install from LunaTranslator Documentation - Download & Launch & Update

Integrating BeeHears into LunaTranslator

LunaTranslator supports integration with locally deployed BeeHears. Please use your own deployed BeeHears, or ensure that the service provider has legitimate upstream authorization and compliance obligations for their BeeHears service. Do not connect API addresses or keys from unknown sources to production environments.

One-Click Configuration

1. In the BeeHears console's System Settings -> Chat Settings, add the following shortcut option:

1. In the BeeHears -> Console -> Token Management tab, select the token you want to use in LunaTranslator, click the dropdown option next to the chat button, choose LunaTranslator, and you will be redirected to LunaTranslator with the API address and API Key automatically configured.

1. In LunaTranslator -> Settings -> Translation Settings -> Large Models, a new large model interface configuration will appear; click Edit.

1. Click the refresh button next to the model dropdown to retrieve the BeeHears platform's model list, select or enter the model name, then click OK to save.

1. Check if the toggle switch next to the new\_api large model interface configuration is turned on. If not enabled, enable the interface to start using it.

Manual Configuration

1. In the BeeHears -> Console -> Token Management tab, obtain the API Key.

1. In LunaTranslator -> Settings - Translation Settings -> Large Models, select Add.

1. Copy the Large Model General Interface template and add a new interface.

1. In the newly added interface, fill in the corresponding API Address and API Key.

1. Click the refresh button next to the model dropdown to retrieve the BeeHears platform's model list, select or enter the model name, then click OK to save.

1. Click the toggle switch next to BeeHears to enable the interface and start using it.

For more usage methods, please refer to the official LunaTranslator documentation: LunaTranslator Documentation - Large Model Translation Interface

🔗 Related links

• Back to docs
• BeeHears Console
• Official
• GitHub
• Upstream reference (New API docs)