Quick Start Guide

This guide will get you translating in under 5 minutes.

If you're not sure where to begin: import a file, translate a few segments, then export back to your CAT tool.

Step 1: Start Supervertaler

Launch the application by running Supervertaler.exe (Windows) or python Supervertaler.py (from source).

INFO

If you want to use AI translation, set up your API keys first: Setting Up API Keys.

Step 2: Import a Document

1. Go to File → Import
2. Choose your file type:
   • DOCX - Standard Word documents
   • Text File - Plain text (one segment per line)
   • memoQ Bilingual - memoQ XLIFF or bilingual DOCX
   • Trados Package - SDLPPX files
   • Phrase Bilingual - Memsource bilingual DOCX
   • CafeTran Bilingual - CafeTran external view
3. Select source and target languages when prompted
4. Your document appears in the translation grid

INFO

If you're working with memoQ/Trados/Phrase/CafeTran, always choose the matching import option so tags and statuses round-trip correctly.

Step 3: Navigate the Grid

The translation grid has 4 columns:

Column	Description
#	Segment number
Status	Translation status indicator
Source	Original text (read-only)
Target	Your translation (editable)

Basic Navigation

Action	Shortcut
Next segment	Enter or ↓ (at end of cell)
Previous segment	↑ (at start of cell)
Go to segment	Ctrl+G

Most navigation is designed to feel memoQ-like: arrow keys move within a cell, and at the top/bottom line they can jump between segments.

Step 4: Translate a Segment

Manual Translation

1. Click in the Target cell
2. Type your translation
3. Confirm the segment (confirmed statuses matter when exporting back to CAT tools)

AI Translation

1. Select a segment
2. Use the Translate action (single segment; Ctrl+T) or Batch Translate (multiple segments)
3. Review and edit if needed
4. Confirm the segment when you're happy

INFO

If AI translation isn't available yet, double-check provider setup in Setting Up API Keys.

Step 5: Save Your Project

1. Press Ctrl+S or go to File → Save Project
2. Choose a location and filename
3. Projects are saved as .svproj files

Step 6: Export Your Translation

1. Go to File → Export
2. Choose the appropriate format:
   • DOCX - Translated Word document
   • Bilingual Table - Side-by-side source/target
   • Return Package - For CAT tool workflows

WARNING

For CAT tool workflows, always export the matching return format (for example, SDLRPX for Trados return packages) to preserve tags and statuses.

---

What's Next?

Recommended next steps

• Setting Up API Keys — enable AI translation
• Installation — verify dependencies and optional components
• CAT Tool Integration — memoQ/Trados/Phrase/CafeTran workflows
• Keyboard Shortcuts — faster editing and navigation

Set up AI TranslationConfigure API keys →Learn Keyboard ShortcutsView all shortcuts →Work with CAT ToolsCAT tool integration →