English | Korean

MangoTL

MangoTL is an AI-powered translation browser extension and self-hostable server for comics, manga, and webtoons.

Add-on Screenshots

Image sample

• Lang: English to Korean
• Provider: OpenRouter
• Model: google/gemma-4-26b-a4b-it

Supported Items

MangoTL supports a variety of websites, languages, AI providers, and OCR engines.

You can check the full list below.

Websites

• Pixiv.net
• X.com

Source and target languages

• Japanese
• Korean
• English
• Chinese
• German
• Swedish

AI Providers

• CrofAI
• OpenRouter
• OpenAI
• Synthetic
• Ollama (local)
• Ollama Cloud
• ZenMux
• Upstage

Detection/OCR Engines

• PaddleOCR — detection, OCR
• manga-ocr (Japanese default) — OCR

Server Install and Setup

Method 1: Docker (recommended)

Requires Docker.

1. The image is published to GHCR on every release and can be run with:

docker pull ghcr.io/gpdir16/mangotl
docker run -d --name mangotl \
    -p 8787:8787 \
    -v mangotl-secrets:/app/server/secrets \
    -v mangotl-ocr-cache:/app/server/.ocr-cache \
    --restart unless-stopped \
    ghcr.io/gpdir16/mangotl

Settings are saved to the mangotl-secrets volume; downloaded OCR models are cached in the mangotl-ocr-cache volume.

2. Open http://localhost:8787/config in your browser and specify the provider, API key, and model in the settings.
3. You can now use MangoTL through the browser add-on. See the browser add-on install section.

Method 2: Run directly

Requires Bun, NodeJS, Git.

1. Clone the Git repository and run it:

git clone https://github.com/gpdir16/MangoTL.git
cd MangoTL
bun install
bun run start

Settings are saved in server/secrets/settings.json.

2. Specify the provider, API key, and model at localhost:8787/config.
3. You can now use MangoTL through the browser add-on. See the browser add-on install section.

Browser Add-on Install and Setup

Method 1: Install from Firefox Add-ons (recommended)

1. Install from Firefox Add-ons.
2. Click the installed add-on icon and open the settings in the popup to set the server URL (if changed) and target language.
3. You can now translate images on websites right away. Try it on the supported websites above.

Method 2: Build and install temporarily

1. Build the release zip: bun run release:extension
2. In Firefox, open about:debugging → This Firefox → Load Temporary Add-on and select a file inside extension/.
3. Click the installed add-on icon and open the settings in the popup to set the server URL (if changed) and target language.
4. You can now translate images on websites right away. Try it on the supported websites above.

Documentation

• Third-party software
• Contributing

License

MangoTL is free software licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).

Copyright © 2026 gpdir16 and MangoTL contributors.

If you modify this software and make it available to users over a network, you must provide the corresponding source code under the same license. See the AGPL FAQ for details.