
# mTRANSLATOR
[](https://openmacapps.com/apps/mtranslator/) [](https://github.com/starbudweiser/mTRANSLATOR/releases/latest) [](LICENSE)
**Translation suite for Bethesda mods (Skyrim SE, Fallout 4, Starfield), native on macOS.**
đŹđ§ English · đ«đ· [Français](#français)
## About
mTRANSLATOR â Translation suite for Bethesda mods (Skyrim SE, Fallout 4, Starfield), native on macOS. By Starbudweiser & Claude Code (Anthropic). MIT License, © 2026 Starbudweiser. Provided as is, without warranty of any kind. See **About mTRANSLATOR** in the app menu.
đ **Native Mac app written in Swift, signed and notarized by Apple.**
mTRANSLATOR opens Bethesda plugins (.esp, .esm, .esl) and string tables, and lets you translate them with xTranslator-compatible SST dictionaries, a self-learning local memory and optional machine translation (Google Translate or Gemini), while protecting game tags. It is inspired by the reference Windows tool xTranslator (by McGuffin) and rebuilt for the Mac.
## Features
- Native reading and writing of **.esp / .esm / .esl** plugins and **.strings / .dlstrings / .ilstrings** tables, plus MCM `.txt` files.
- **SST dictionaries** (xTranslator format): exact matches applied instantly, close matches suggested for review.
- **Self-learning local memory**: every validated line is remembered and reused first in your next mods.
- **Machine translation**: free Google Translate, or Gemini with your own key; tags such as ``, `[pagebreak]` and Papyrus variables are protected.
- **Batch processing**: translate several plugins at once with the dictionaries, AI for the rest.
- Find & replace (with regex), statistics and report, diff between two versions of a mod.
- Exports: translated plugin (with timestamped backup), SST, xTranslator XML, CSV, TXT, JSON.
- Interface language independent from the translation language (FR, EN, IT, ES).
- Interface in **English, French, Italian and Spanish** (follows your Mac's language; can be changed in the app).
### What's new in 1.4.0
- The macOS app is now native Swift (AppKit + WebKit) instead of a packaged Python program, so antivirus scanners no longer flag it. Same interface, same dictionaries, same machine translation (Google, Gemini), same menus and languages.
- The local dictionary is much lighter on disk (existing dictionaries are migrated automatically on first launch).
- Dictionaries window: header on one line, tabs no longer wrap, maintenance actions moved to a separate bar.
- Automatic translation window: the batch size menu no longer overflows its card.
- Local base: warning that xTranslator's .sst files are binary and must not be scanned there; set their folder in the editor's Suggestions panel instead (README updated).
### Screenshots

*Welcome screen*

*Translation table, tag protection and line editor*
### Privacy
Plugins and dictionaries stay on your Mac. Only the texts you send to machine translation leave it (to Google). The Gemini key is kept on this Mac.
## Install
**[Download the latest notarized release](https://github.com/starbudweiser/mTRANSLATOR/releases/latest)** · requires **macOS 15 Sequoia** or later on Apple Silicon.
### Requirements
A Mac with **Apple Silicon** (M1 or later), **macOS 15 Sequoia** or later. Native Mac app written in Swift and notarized by Apple: no Python, no Wine, no virtual machine needed.
### Installation
1. Download the zip from Nexus Mods (or from the GitHub releases) and unzip it.
2. Move **mTRANSLATOR.app** to your **Applications** folder.
### How to use
1. Choose the translation language with the **English â âŠ** button at the top right (the flag next to it sets the interface language).
2. Click **Open a file** (or drop a plugin on the window). Try a built-in demo project first if you like.
3. In the editor, point the **Suggestions** panel at your xTranslator dictionaries folder (folder icon, once). Then click **Translate with the SST dictionaries** to fill in everything the official dictionaries know.
4. Translate the remaining lines by hand (F10 validates and moves to the next one) or with **Auto-translate**.
5. Click **Save** (âS): overwrite with a backup, save a copy, or download a ZIP pack.
### Updates
The app checks once a day whether a newer release exists on GitHub and offers to open the Nexus page, remind you later or skip that version. Nothing is downloaded or installed automatically. The full history is in [CHANGELOG.md](CHANGELOG.md).
## Build
Requires Xcode (Swift 6), Node.js and Rust. The macOS app is native Swift (AppKit + WebKit) around the React interface and the Rust core. From the repository folder:
```bash
./build_app.sh
```
â [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)
## Languages
English, French, Spanish and Italian. The app follows your Mac's preferred language automatically (English if it is none of these four).
## Support
đŹ Help and community: [Skyrim Mac Toolkit Discord](https://discord.gg/jRS4rvynx6) · bug reports: [GitHub Issues](https://github.com/starbudweiser/mTRANSLATOR/issues).
### FAQ
**Where do I get SST dictionaries?**
Use the official ones extracted from the game with xTranslator, or build your own from your translations (Dictionaries â Create).
**Can I load my xTranslator dictionaries folder (`UserDictionaries`)?**
Yes: in the editor, click the folder icon in the **Suggestions** panel and choose the folder (for example `âŠ/UserDictionaries/SkyrimSE`). Its `.sst` files are read directly (exact and close matches, official names for automatic translation). Do **not** use *Dictionaries â Local base â Scan a folder* on it: that button reads `.sst` files as XML text, while xTranslator's `.sst` files are binary, and it would fill the local base with unreadable entries. Use it only for text-based dictionaries (`.txt`, `.csv`, `.json`, XML `.sst`).
**Is a Gemini key required?**
No. Without a key, free Google Translate is used. The Gemini key (free at aistudio.google.com) gives better results for dialogues and books.
## License
Released under the **MIT License**: free to use, modify and share. Part of the **Skyrim Mac Toolkit**, a set of modding tools built for Skyrim players on Mac. See [LICENSE](LICENSE).
---
## Français
**Suite de traduction de mods Bethesda (Skyrim SE, Fallout 4, Starfield), native sur macOS.**
đ *Appli Mac native Ă©crite en Swift, signĂ©e et notarisĂ©e par Apple.*
đŹ Aide et communautĂ© : [Discord du Skyrim Mac Toolkit](https://discord.gg/jRS4rvynx6)
### à quoi ça sert
mTRANSLATOR ouvre les plugins Bethesda (.esp, .esm, .esl) et les tables de chaßnes, et permet de les traduire avec des dictionnaires SST compatibles xTranslator, une mémoire locale qui apprend toute seule et une traduction automatique facultative (Google Traduction ou Gemini), en protégeant les balises du jeu. Il s'inspire de l'outil Windows de référence xTranslator (de McGuffin), reconstruit pour le Mac.
### Fonctions
- Lecture et écriture natives des plugins **.esp / .esm / .esl** et des tables **.strings / .dlstrings / .ilstrings**, ainsi que des fichiers `.txt` de MCM.
- **Dictionnaires SST** (format xTranslator) : correspondances exactes appliquées instantanément, correspondances proches proposées à la relecture.
- **Mémoire locale qui apprend** : chaque ligne validée est retenue et réutilisée en priorité sur vos mods suivants.
- **Traduction automatique** : Google Traduction gratuit, ou Gemini avec votre clé ; les balises ``, `[pagebreak]` et variables Papyrus sont protégées.
- **Traitement par lots** : traduisez plusieurs plugins d'un coup avec les dictionnaires, l'IA pour le reste.
- Rechercher/remplacer (avec regex), statistiques et rapport, comparaison entre deux versions d'un mod.
- Exports : plugin traduit (avec sauvegarde horodatée), SST, XML xTranslator, CSV, TXT, JSON.
- Langue de l'interface indépendante de la langue de traduction (FR, EN, IT, ES).
- Interface en **français, anglais, italien et espagnol** (suit la langue du Mac ; modifiable dans l'appli).
### Nouveautés de la 1.4.0
- L'appli macOS est maintenant native en Swift (AppKit + WebKit) au lieu d'un programme Python empaquetĂ©, ce qui Ă©vite les fausses alertes antivirus. MĂȘme interface, mĂȘmes dictionnaires, mĂȘme traduction automatique (Google, Gemini), mĂȘmes menus et langues.
- Le dictionnaire local est beaucoup plus léger sur le disque (les dictionnaires existants sont migrés automatiquement au premier lancement).
- FenĂȘtre Dictionnaires : en-tĂȘte sur une ligne, onglets sans retour Ă la ligne, actions de maintenance sur une barre Ă part.
- FenĂȘtre de traduction automatique : le menu de taille des lots ne dĂ©borde plus de sa carte.
- Base locale : avertissement indiquant que les .sst d'xTranslator sont binaires et ne doivent pas y ĂȘtre scannĂ©s ; indiquez plutĂŽt leur dossier dans le panneau Suggestions de l'Ă©diteur (README mis Ă jour).
### Mises Ă jour
L'appli vérifie une fois par jour si une version plus récente existe sur GitHub et propose d'ouvrir la page Nexus, de rappeler plus tard ou d'ignorer cette version. Rien n'est téléchargé ni installé automatiquement. L'historique complet est dans [CHANGELOG.md](CHANGELOG.md).
### Captures d'écran

*Ăcran d'accueil*

*Table de traduction, protection des balises et éditeur de ligne*
### Configuration requise
Un Mac **Apple Silicon** (M1 ou plus récent), **macOS 15 Sequoia** ou plus récent. Appli Mac native écrite en Swift et notarisée par Apple : ni Python, ni Wine, ni machine virtuelle.
### Installation
1. Téléchargez le zip sur Nexus Mods (ou dans les releases GitHub) et décompressez-le.
2. Placez **mTRANSLATOR.app** dans votre dossier **Applications**.
### Utilisation
1. Choisissez la langue de traduction avec le bouton **English â âŠ** en haut Ă droite (le drapeau Ă cĂŽtĂ© rĂšgle la langue de l'interface).
2. Cliquez sur **Ouvrir un fichier** (ou dĂ©posez un plugin sur la fenĂȘtre). Essayez d'abord un projet de dĂ©mo si vous voulez.
3. Dans l'éditeur, indiquez à **Suggestions** le dossier de vos dictionnaires xTranslator (icÎne dossier, une seule fois). Puis cliquez sur **Traduire avec les dictionnaires SST** pour remplir tout ce que connaissent les dictionnaires officiels.
4. Traduisez les lignes restantes Ă la main (F10 valide et passe Ă la suivante) ou avec **Traduire automatiquement**.
5. Cliquez sur **Enregistrer** (âS) : Ă©craser avec sauvegarde, enregistrer une copie ou tĂ©lĂ©charger un pack ZIP.
### Questions fréquentes
**OĂč trouver des dictionnaires SST ?**
Utilisez les dictionnaires officiels extraits du jeu avec xTranslator, ou crĂ©ez les vĂŽtres Ă partir de vos traductions (Dictionnaires â CrĂ©er).
**Puis-je charger mon dossier de dictionnaires xTranslator (`UserDictionaries`) ?**
Oui : dans l'Ă©diteur, cliquez sur l'icĂŽne dossier du panneau **Suggestions** et choisissez le dossier (par exemple `âŠ/UserDictionaries/SkyrimSE`). Ses fichiers `.sst` sont lus directement (correspondances exactes et proches, noms officiels pour la traduction automatique). N'utilisez **pas** *Dictionnaires â Base locale â Scanner un dossier* dessus : ce bouton lit les `.sst` comme du texte XML, alors que les `.sst` de xTranslator sont binaires, et il remplirait la base locale d'entrĂ©es illisibles. Il ne sert que pour des dictionnaires en texte (`.txt`, `.csv`, `.json`, `.sst` XML).
**Faut-il une clé Gemini ?**
Non. Sans clé, Google Traduction gratuit est utilisé. La clé Gemini (gratuite sur aistudio.google.com) donne de meilleurs résultats pour les dialogues et les livres.
### Confidentialité
Les plugins et dictionnaires restent sur votre Mac. Seuls les textes envoyés à la traduction automatique en sortent (vers Google). La clé Gemini reste sur ce Mac.
### Compiler depuis les sources
NĂ©cessite Xcode (Swift 6), Node.js et Rust. L'appli macOS est native en Swift (AppKit + WebKit) autour de l'interface React et du cĆur Rust. Depuis le dossier du dĂ©pĂŽt :
```bash
./build_app.sh
```
â [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)
### Licence
Publié sous **licence MIT** : libre d'utilisation, de modification et de partage. Fait partie du **Skyrim Mac Toolkit**, un ensemble d'outils de modding pensés pour les joueurs de Skyrim sur Mac.