Skip to content

desertseller/FluxTranslator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FluxTranslator

FluxTranslator is a Windows desktop overlay for speech to text translation. It listens to your microphone, recognises speech, translates it in real time and displays the result in a compact on screen overlay. Supports Voice TTS, translated audio can be routed to microphone via VBCable so other apps can receive the translated speech as mic input.

FluxTranslator

General Appearance
Behavior tab Hotkeys
Voice TTS

Features

  • Speech recognition using your microphone.
  • Real-time translation with two translation modes:
    • LibreTranslate
    • CTranslate2
  • Overlay UI that displays translated text on top of other applications.
  • Customisable appearance including font, size, colors, opacity, padding, borders, and screen position.
  • Hotkey support for starting recognition, copying the last translation, and stopping everything quickly.
  • Model management directly from the app.
  • Voice TTS When using VBCable to route audio to the microphone. This is useful when you want to speak in your own language and pass the translated voice output into another app or call.

How to install

Requirements

  • .NET 8 SDK or later
  • Windows 11 / 10
  • Python 3.14
  • FFmpeg
  • VBCable if you want to feed Voice TTS into a microphone input

Installation

  1. Go to the Releases.
  2. Download FluxTranslator_Setup.exe.
  3. Run the installer and follow the instructions.
  4. Launch the app via the Desktop shortcut or Start Menu.

Warning

Windows SmartScreen

Because this project is free and open source the installer does not come with a digital certificate. Windows may display a SmartScreen message when you first run it.

Build from source

Building locally ensures the exe has a unique binary signature.

  1. Go to the Releases or clone this repo.
  2. Download the latest source code.
  3. Open a PowerShell in the repository.
  4. Run script:
powershell -ExecutionPolicy Bypass -File .\build.ps1
  1. The compiled output lands in the build\ folder. Run FluxTranslator.exe from there.

You can customize the output directory:

-OutputDir "set path" 
  1. Install python dependencies:
pip install -r requirements.txt

Important

For FluxTranslator to work correctly first run fluxhelper.py then run FluxTranslator.exe

Voice TTS

Translation Engines

CTranslate2 (Recommended)

  • Uses Helsinki-NLP/opus-mt models converted for CTranslate2
  • Best choice if you want local translation without depending on an external service.

Note

Even though CTranslate2 is recommended not every language pair is available. In some cases a specific pair may be missing and the only working option will be LibreTranslate.

LibreTranslate

  • Default endpoint: http://localhost:5000/translate

LibreTranslate setup with Docker

  • If LibreTranslate is not installed yet, the easiest way to run it is with Docker.
  1. Download and install Docker Desktop from docker.com.
  2. Start Docker Desktop and wait until Docker is running.
  3. Run the command below in terminal. This command will install a LibreTranslate instance with the selected languages in Docker:
docker run -d --name libretranslate -p 5000:5000 -e LT_LOAD_ONLY=LANG,LANG libretranslate/libretranslate

Note

Replace LANG,LANG with the languages of your choice. Example: LT_LOAD_ONLY=en,pl,de

Supported Languages

FluxTranslator includes support for common source and target languages (ISO 639-1 codes):

Language Code
English en
Polish pl
German de
Russian ru
French fr
Italian it
Spanish es
Czech cs
Ukrainian uk
Chinese zh
Japanese ja
Korean ko
Portuguese pt
Dutch nl
Swedish sv
Finnish fi
Danish da
Norwegian no
Turkish tr
Arabic ar

About

  • Developed by Pawel Kawka.
  • Open source and free to use.
  • Voice TTS is implemented using edge-tts

About

FluxTranslator is a Windows desktop overlay for speech to text translation and Voice TTS

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors