A collection of plugins for Aurex Translator — a cross-platform real-time text translator for Windows and Linux (X11/Wayland) that supports both OCR screen capture and plugin-based text hooking.
aurextranslator-plugins/
├── 📁 example/ # Basic plugin example and test target
├── 📁 injector/ # libat-injector: wrapper library for managing at-injector
│ └── 📁 bin/ # at-injector: CLI utility for loading/unloading libraries
├── 📁 games/ # Game-specific plugins
│ └── 📁 imhhw/ # If My Heart Had Wings
├── 📁 engines/ # Engine-specific plugins
│ ├── 📁 renpy/ # Ren'Py visual novel engine
│ ├── 📁 kirikiri/ # KiriKiri / KiriKiriZ visual novel engine
│ └── 📁 unity/ # Unity games (Mono and IL2CPP)
├── 📁 overlay/ # libat-overlay: in-game overlay (translated text over the game, frame capture)
The system consists of four key components that exchange data via a named-pipe/socket protocol:
- Dynamic libraries written for specific games or game engines
- Intercept text output functions and pass the original text over the pipe
libat-injector— wrapper library that managesat-injector: launches it with the required parameters and organizes data exchange via a named-pipe/socket IPCat-injector(inbin/) — CLI utility for loading (load) or unloading (unload) libraries into the address space of a running process. Available for x86 and x64.
libat-overlay— draws the translated text over the game and sends the game image back to Aurex Translator for OCR- Windows: one DLL, loaded into the game by
libat-injector, that hooks Direct3D 9/10/11/12 and OpenGL and is also registered as a Vulkan layer - Linux: a Vulkan layer and an OpenGL
LD_PRELOADshim, both enabled by a launcher script that Aurex Translator creates - Talks to the application over its own named-pipe/socket protocol (
include/host/overlay_protocol.h)
- Main application that receives text from plugins, translates it using the selected service, and displays it in a separate window
- Qt6
- libcap (on Linux)
- Overlay, Linux: Vulkan, OpenGL and EGL development packages (
libvulkan-dev,libgl-dev,libegl-dev)
git clone https://github.com/kirizaku/aurextranslator-plugins.git
cd aurextranslator-plugins
mkdir build && cd build
cmake .. -DBUILD_EXAMPLE_PLUGIN=ON # ← enables building the example plugin
cmake --build .NOTE:
BUILD_EXAMPLE_PLUGINoption controls whether the example plugin and test target are built. It is disabled by default, so you must explicitly enable it.
After a successful build, binaries and dynamic libraries will be placed in the plugins/ directory at the project root. The compiled example can be found in example/output/.
On Linux, process injection requires ptrace privileges. To prevent the program from asking for admin rights every time, run these commands once after building or installing:
sudo setcap cap_sys_ptrace+ep /path/to/at-injector_x86
sudo setcap cap_sys_ptrace+ep /path/to/at-injector_x64NOTE: If you rebuild the plugins, the permissions will be reset — you need to run the commands again.
Copy the built plugins to the Aurex Translator plugins directory:
| Platform | Path |
|---|---|
| Linux | ~/.config/AurexTranslator/plugins/ |
| Windows | %LOCALAPPDATA%\AurexTranslator\plugins\ |
The repository provides a template (example/) for creating new plugins.
| File | Purpose |
|---|---|
libat-example.so |
Sample plugin implementing the basic interception interface |
test_target |
Test target program that simulates a game's behavior |
-
Launch the target
./example/output/test_target
-
Configure Aurex Translator
- Open Text Processing → HOOK
- Select the
test_targetprocess as the injection target
-
Check the result
- The plugin will intercept
fwritefunction calls intest_target - The captured text will appear in the Aurex Translator window
- The plugin will intercept
Important! Different components of this repository are distributed under different licenses:
| Component | License | Path |
|---|---|---|
Game plugins (games/*) |
MIT | /games/ |
Engine plugins (engines/*) |
MIT | /engines/ |
Example plugin (example/*) |
MIT | /example/ |
| libat-injector | GPL-3.0 | /injector/libat-injector/ |
| at-injector (CLI utility) | MIT | /injector/bin/ |
| libat-overlay (in-game overlay) | GPL-2.0-or-later, includes code from obs-vkcapture, obs-studio, MangoHud and Dear ImGui (see overlay/NOTICE) |
/overlay/ |
Bundled third-party code keeps its own license file next to it: Hacker Disassembler Engine (BSD 2-clause, include/hook/hde/), Python 3.10 headers (PSF License, engines/renpy/src/python/) and Dear ImGui (MIT, overlay/third_party/imgui/) and Microsoft Detours (MIT, overlay/third_party/detours/). On Linux libat-injector also links libcap statically (BSD-3-Clause or GPL-2.0) and Qt dynamically (LGPL-3.0). Binary releases ship the full license texts in THIRD-PARTY-LICENSES.