- Compatible XF 2.x versions
- 2.0
- 2.1
- 2.2
- 2.3
Features
Translates 11,000+ XenForo phrases automatically
Preserves XenForo variables ({username}, {count}, {board}, etc.)
Preserves HTML tags inside phrases
Auto-saves progress — safely resume if interrupted
Remembers your API key — enter once, never again
Remembers your last used language
Simple interactive menu — no command-line knowledge needed
Batch processing with real-time progress bar
Getting Started
Step 1 — Export your XenForo language file
- Log in to your XenForo Admin Panel
- Navigate to Appearance → Languages
- Click the download icon next to English (US)
- Save the
.xmlfile into this folder
Step 2 — Run the tool
Windows — double-clickrun.batTerminal:
python xf_translate.py
Step 3 — Select target language
Code:
╔══════════════════════════════════════════════════════╗
║ XenForo Auto Translate | DeepL API ║
╚══════════════════════════════════════════════════════╝
Select Target Language
──────────────────────────────────────────────────
1. Arabic [AR] 16. Norwegian [NB]
2. Bulgarian [BG] 17. Dutch [NL]
3. Czech [CS] 18. Polish [PL]
...
28. Turkish [TR] ◄ (last used)
...
Enter number [28]:Step 4 — Watch it translate
Code:
[████████████████████] 100% 11,141/11,141 almost done
╔══════════════════════════════════════════╗
║ TRANSLATION COMPLETE! ║
╚══════════════════════════════════════════╝
Output : language-Turkish-XF.xml
Phrases: 11,141 total translatedStep 5 — Import into XenForo
- Go to Appearance → Languages → Import
- Select the output
.xmlfile - Click Import
Supported Languages
| Code | Language | Code | Language |
|---|---|---|---|
| AR | Arabic | NB | Norwegian |
| BG | Bulgarian | NL | Dutch |
| CS | Czech | PL | Polish |
| DA | Danish | PT-BR | Portuguese (Brazil) |
| DE | German | PT-PT | Portuguese (Europe) |
| EL | Greek | RO | Romanian |
| ES | Spanish | RU | Russian |
| ET | Estonian | SK | Slovak |
| FI | Finnish | SL | Slovenian |
| FR | French | SV | Swedish |
| HU | Hungarian | TR | Turkish |
| ID | Indonesian | UK | Ukrainian |
| IT | Italian | ZH | Chinese (Simplified) |
| JA | Japanese | KO | Korean |
| LT | Lithuanian | LV | Latvian |
Command-line Options
python xf_translate.py # interactive modepython xf_translate.py myfile.xml # specify source file directly
python xf_translate.py --reset-key # change your saved API key
File Structure
Code:
XenForo Auto Translate/
├── xf_translate.py # main script
├── run.bat # Windows one-click launcher
├── README.md # documentation
└── .gitignore
# Generated files (git-ignored):
├── language-*-XF.xml # translated output files
└── .progress_*.json # auto-save files (deleted on completion)
Troubleshooting
| Problem | Solution |
|---|---|
deepl package not found | Run python -m pip install deepl |
Invalid API key | Check your key at deepl.com or use --reset-key |
Quota exceeded | Free limit reached — progress is saved, re-run next month |
| No XML files found in tool | Export the language file from XenForo admin panel first |
| XenForo: not a valid XML file | Re-run — output may have been incomplete |