User Guide

Learn how to use Cacahuatl Translator

Before You Start

Please prepare the following before using the translator:

  • 1
    Prepare your Cacahuatl Translator license key. (Purchase from the product page, delivered via email)
  • 2
    Prepare an API key for the language model you want to use. (OpenAI recommended, API usage fees are billed separately by each provider)

    * To get an API key, you need to sign up and register a payment method on each provider's website.

  • 3 Prepare Excel files (.xlsx, .xls) for translation

File Format Guide

Translation File Format

Prepare an Excel file with source text in Column A. Column B (target) should be empty - the translator will fill it in.

Column A (Source Language) Column B (Target Language)
Hello (empty)
Start the game (empty)
Save progress (empty)

Glossary (TermBase) File Format

Prepare an Excel file with source terms in Column A and their translations in Column B. This ensures consistent translation of proper nouns.

Column A (Source Term) Column B (Target Term)
Elf 엘프
Dragon King 드래곤킹
Magic Stone 마법석

8-Step Translation Guide

1

Select Language Model

Choose the AI provider and model for translation.

  • Choose Provider: Select from OpenAI, Google Gemini, or Anthropic Claude based on your API key.
  • Choose Model: Select the specific model version (e.g., GPT-4o, GPT-4.1, Gemini 2.0, Claude 3.5 Sonnet).
  • Processing Tier:
    Real-time: Immediate processing, higher cost
    Batch: Background processing, up to 50% cost savings (OpenAI/Claude only)
Step 1: Select Language Model
2

Register API Key

Enter the API key from your selected provider.

  • How to get API keys:
  • OpenAI: platform.openai.com → API Keys
  • Google Gemini: aistudio.google.com → Get API Key
  • Anthropic: console.anthropic.com → API Keys
  • Your API keys are encrypted and stored securely on your device.
  • API usage costs are billed separately by each provider (OpenAI, Google, Anthropic).
Step 2: Register API Key
3

Select Languages

Choose the source and target languages for translation.

  • Source Language (Left): Select the language of your original text
  • Target Language (Right): Select the language to translate into
  • 26 languages available across 4 tiers:
  • TIER 1: English, Spanish, French, German, Italian, Portuguese
  • TIER 2: Russian, Chinese (Simplified/Traditional), Japanese, Korean, Arabic
  • TIER 3: Dutch, Polish, Swedish, Turkish, Thai, Vietnamese
  • TIER 4: Danish, Norwegian, Finnish, Czech, Hebrew, Hindi, Indonesian, Malay
Step 3: Select Languages
4

Configure Translation Options

Set options to control how text is translated.

  • Preserve Special Characters: Keeps format strings like %s, %d, {0}, {name} in their original positions.
  • Preserve Formatting: Maintains line breaks, indentation, and whitespace from the original text.
  • Case Sensitive: Recognizes and preserves patterns like CONSTANT_NAME and PascalCase.
Step 4: Configure Translation Options
5

Select Work Folder

Choose the folder containing your translation files.

  • Click the folder select button and choose your work directory.
  • All Excel files (.xlsx, .xls) in the selected folder will be automatically detected.
  • Make sure your files follow the format described in the File Format Guide above.
Step 5: Select Work Folder
6

Apply Glossary (Optional)

Load a glossary file for consistent terminology.

  • This step is optional but recommended for game translations.
  • Ensures character names, item names, and game-specific terms are translated consistently.
  • The glossary file should follow the format described in the File Format Guide above.
Step 6: Apply Glossary
7

Start Translation

Begin the translation process.

  • After confirming all settings, click the 'Start Translation' button.
  • Real-time mode: Translation happens immediately. You can see results as they complete.
  • Batch mode: Translation is queued for background processing. Check status anytime with the Status button.
  • You can cancel ongoing translations using the Cancel button.
Step 7: Start Translation
8

Check Processing Log

Monitor translation progress in the log panel.

  • View real-time progress including file counts and completion status.
  • Any errors or warnings will be displayed here for troubleshooting.
  • When complete, you'll see a summary of all processed files.

Check Results

Translated files are saved in a '{OriginalFolderName}_translated' folder created on your Desktop.

Output files keep the same filename as the original.

.xls files are converted and saved as .xlsx format.

Example: MyProjectDesktop/MyProject_translated/game_texts.xlsx

Tips for Best Results

💡 Always use a glossary for game translations to maintain consistency.

💡 Test with a small file first before processing large batches.

💡 Use Batch mode for large projects to save on API costs.

💡 Keep format strings (%s, {0}) intact - they are placeholders for game variables.

← Back to Product Page