Skip to main content

Usage Guide (Quick Start)

This guide follows a practical step-by-step flow to help you complete first-time setup.

1. Install and Launch​

  1. Download and install Mask.
  2. On first launch, grant required system permissions (for example, Screen Recording).
  3. Open Settings and confirm the app version displays correctly.

2. Select a Model Provider and Add API Key​

  1. In Settings, choose the model provider you want to use.
  2. Paste the corresponding API key.
  3. Save and run a small test translation.

If you do not have a key yet, read API Key Setup first.

3. Start Translating​

  1. Select the screen region you want to translate.
  2. Wait for OCR and model processing.
  3. Check the overlay result. If needed, adjust the selection and retry.

4. Practical Tips for Better Quality​

  • For dense text, segment-by-segment translation is usually more stable.
  • Keeping nearby context improves coherence significantly.
  • For small fonts, zoom in first to reduce OCR misses.

5. Recommendations by Scenario​

Comics / Game Dialogues​

  • Focus on one dialogue box per selection.
  • Avoid selecting portraits, visual effects, and decorative text together.

Document / Web Reading​

  • Translate paragraphs in semantic chunks.
  • For terminology-heavy content, reuse the same model for consistency.

6. Daily Maintenance Tips​

  • Keep Mask updated to the latest version.
  • If you switch providers, verify key permissions and quota.
  • For errors, run a minimal test (single sentence, small region) first for faster diagnosis.

7. Next Steps​