# TransLite

> TransLite is a self-hosted, open-source translation web UI that puts Google, DeepL, Yandex and DuckDuckGo behind one form, with opt-in JS and keyboard accesskeys.

- **Category:** [Translation](https://selfhost.directory/translation)
- **Licence:** Unlicense
- **Source model:** Open source
- **Author:** gospodin
- **Platforms:** Docker Compose, Build from Source
- **Ports:** 8080 (HTTP listener of the TransLite container)
- **Tags:** Privacy, Lightweight, Translation, Php, Front end, Yandex, Deepl, Language detection, Keyboard shortcuts, Google translate, Duckduckgo

## Docker images

- [`git.bloat.cat/gospodin/translite`](https://git.bloat.cat/gospodin/translite)

## What is TransLite?

TransLite puts a single plain translation form in front of Google Translate, DeepL, Yandex and DuckDuckGo Translate, so you can use those engines without visiting their sites. Visitors pick one engine or turn on several at once, choose source and target languages from long per-engine lists (autodetect is available on the source side), swap the two directions, and read the result in a second text area with audio buttons next to each side. JavaScript stays off unless the user opts in, which then gives automatic text-area resizing and swap/clear without a page reload; switching to POST requests lifts the form's 2000-character GET limit for longer input, at the cost of translation links no longer carrying the text. Accesskeys cover both language lists, both text areas, both audio buttons, swap, translate and clear. A settings page holds engine, language-selector style and default-language choices with Save and Reset. Instance owners can set default source and target languages and the GET form length through environment variables. Self-hosting means either running the published container image behind Docker Compose or installing the PHP files yourself with php-fpm and a few extensions, plus a web server. There is no account system or login; the code is published under the Unlicense, and the public instance at tl.bloat.cat shows what you get.

## Should you self-host TransLite?

TransLite scores **49/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#8 of 11** in [Translation](https://selfhost.directory/translation).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Unlicense-licensed.

Its closest alternative on selfhost.directory is [LibreTranslate](https://selfhost.directory/project/libretranslate) (79/100, 17 771 stars). It scores higher overall, so compare the two before you pick. [See TransLite vs LibreTranslate side by side.](https://selfhost.directory/compare/libretranslate-vs-translite)

## Features

- Audio playback buttons
- Configurable form length limit
- Keyboard Shortcuts
- Language autodetection
- Multiple translation engines
- Opt-in JavaScript
- Per-user settings page
- POST translation mode

## How to install TransLite

### Install TransLite with Docker Compose

Environment variables:

```
MAX_LINK_LENGTH, PREF_SL, PREF_TL
```

Copy compose.example.yaml to compose.yaml, edit it to suit your needs and run `docker compose up -d`.

Note: Image published at git.bloat.cat/gospodin/translite; commit-linked tags let you revert a broken image.

### Install TransLite with Build from Source

Requirements: php, php-brotli, php-curl, php-dom, php-fpm, php-pecl-apcu, php-session

You will need these php packages to run TransLite:

- php
- php-brotli
- php-curl
- php-dom
- php-fpm
- php-pecl-apcu
- php-session

Note: Run `composer install --optimize-autoloader` for a production environment; missing extensions can come from PECL or composer.

## TransLite alternatives

- [Libre Translate](https://selfhost.directory/project/libre-translate): Free and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup. (compare: https://selfhost.directory/compare/libre-translate-vs-translite)
- [LibreTranslate](https://selfhost.directory/project/libretranslate): Open-source, self-hosted machine translation API powered by Argos Translate. Runs offline; REST endpoints, web UI, file translation, API keys. (compare: https://selfhost.directory/compare/libretranslate-vs-translite)
- [SimplyTranslate](https://selfhost.directory/project/simplytranslate): Self-hosted, open-source frontend for multiple translation engines (Google Translate, iCIBA, Reverso) with a web UI, JSON API and text-to-speech. (compare: https://selfhost.directory/compare/simplytranslate-vs-translite)
- [lingva-translate](https://selfhost.directory/project/lingva-translate): Open-source Google Translate front-end that scrapes translations so browsers avoid Google tracking; self-hosted with Docker, REST and GraphQL APIs, 100+ languages. (compare: https://selfhost.directory/compare/lingva-translate-vs-translite)
- [MTranServer](https://selfhost.directory/project/mtranserver): Open-source, self-hosted offline translation server that runs without a GPU, with DeepL, Google and Immersive Translate compatible APIs; run via Docker or npm. (compare: https://selfhost.directory/compare/mtranserver-vs-translite)
- [Ever Traduora](https://selfhost.directory/project/ever-traduora): Self-hosted, open-source tool for managing app translations: teams edit strings together, and files move in and out as JSON, YAML, XLIFF, PO and more. (compare: https://selfhost.directory/compare/ever-traduora-vs-translite)
- [OmniPoly](https://selfhost.directory/project/omnipoly): OmniPoly is a self-hosted, open-source web frontend unifying translation (LibreTranslate), grammar checking (LanguageTool), and AI text analysis (Ollama). (compare: https://selfhost.directory/compare/omnipoly-vs-translite)
- [Lingarr](https://selfhost.directory/project/lingarr): Self-hosted, open-source app that translates movie and TV subtitle files using LibreTranslate, DeepL, Google, or AI providers like OpenAI and Ollama. (compare: https://selfhost.directory/compare/lingarr-vs-translite)

## More in Translation

- [Whisper-WebUI](https://selfhost.directory/project/whisper-webui): Self-hosted Gradio web UI that turns Whisper speech recognition into an easy subtitle generator: transcribe files, YouTube links or microphone.
- [Accent](https://selfhost.directory/project/accent): Self-hosted, open-source translation management platform for developers with CLI, GraphQL API, history rollback, and multiple format support.
- [Ever Traduora](https://selfhost.directory/project/ever-traduora): Self-hosted, open-source tool for managing app translations: teams edit strings together, and files move in and out as JSON, YAML, XLIFF, PO and more.
- [Languine](https://selfhost.directory/project/languine): Self-hosted, open-source AI localization: a Next.js dashboard, CLI and GitHub Action that translate JSON, Markdown, iOS and Android files via a configurable model.
- [Libre Translate](https://selfhost.directory/project/libre-translate): Free and Open Source Machine Translation API. Self-hosted, offline capable and easy to setup.
- [LibreTranslate](https://selfhost.directory/project/libretranslate): Open-source, self-hosted machine translation API powered by Argos Translate. Runs offline; REST endpoints, web UI, file translation, API keys.
- [Lingarr](https://selfhost.directory/project/lingarr): Self-hosted, open-source app that translates movie and TV subtitle files using LibreTranslate, DeepL, Google, or AI providers like OpenAI and Ollama.
- [lingva-translate](https://selfhost.directory/project/lingva-translate): Open-source Google Translate front-end that scrapes translations so browsers avoid Google tracking; self-hosted with Docker, REST and GraphQL APIs, 100+ languages.
- [llot](https://selfhost.directory/project/llot): Self-hosted, open-source translation service using local LLMs via Ollama with 38 languages, real-time translation, dark mode, and Wyoming TTS support.
- [MTranServer](https://selfhost.directory/project/mtranserver): Open-source, self-hosted offline translation server that runs without a GPU, with DeepL, Google and Immersive Translate compatible APIs; run via Docker or npm.
- [OmniPoly](https://selfhost.directory/project/omnipoly): OmniPoly is a self-hosted, open-source web frontend unifying translation (LibreTranslate), grammar checking (LanguageTool), and AI text analysis (Ollama).
- [OmniVoice-Studio](https://selfhost.directory/project/omnivoice-studio): This self-hosted, open-source ElevenLabs alternative clones and designs voices, dubs video and builds audiobooks in 646 languages, fully local on desktop or Docker.

## Links

- [Homepage](https://codeberg.org/gospodin/translite)
- [Website](https://tl.bloat.cat)
- [Source repository](https://codeberg.org/gospodin/translite)

---
Source: https://selfhost.directory/project/translite