Argo Translate GoldenDict Integration

A configuration guide and ecosystem for integrating Argo Translate with GoldenDict-ng for offline translation.

Table of Contents

• Argo Translate GoldenDict Integration
  • Table of Contents
  • Description
  • Features
  • Installation
    • 1. Environment Setup
    • 2. Installing Languages
    • 3. GoldenDict-ng Configuration
  • Usage
  • Kardenwort Ecosystem
  • License

---

Description

This project provides the necessary configuration and environment setup to use Argo Translate as an external program within GoldenDict-ng. It enables offline translation capabilities directly within your dictionary interface.

Return to Top

Features

• Offline Translation: Uses Argo Translate for neural machine translation without an internet connection.
• GoldenDict Integration: Seamlessly integrates into GoldenDict-ng using external program definitions.
• Multiple Language Pairs: Supports configuration for various language pairs (e.g., En-Ru, En-De, De-Ru).

Return to Top

Installation

1. Environment Setup

Ensure you have a Python environment with argos-translate installed.

# Example setup
python -m venv venv
.\venv\Scripts\activate
pip install argos-translate

2. Installing Languages

To use the configured language pairs, you must install the corresponding packages. Since some direct translations (like German <-> Russian) use English as a pivot, installing the English pairs covers all configurations.

1. Update the package index:

   argospm update

2. Install the required language packages:

   # English <-> Russian
   argospm install translate-en_ru
   argospm install translate-ru_en
   
   # English <-> German
   argospm install translate-en_de
   argospm install translate-de_en

   Note: Installing these four packages enables En-Ru, En-De, De-En, Ru-En, as well as De-Ru and Ru-De (via English pivot).

3. GoldenDict-ng Configuration

To add the translators to GoldenDict-ng:

1. Open GoldenDict-ng.
2. Navigate to Edit > Dictionaries > Programs.
3. Add a new entry for each language pair you wish to support.
4. Use the following configuration patterns (adjust usage of python.exe and argos-translate paths to match your environment):

English -> Russian

• Name: aR En-Ru
• Command Line:

  "U:\voothi\20241121100211-argotranslate\venv\Scripts\python.exe" "U:\voothi\20241121100211-argotranslate\venv\Scripts\argos-translate" -f en -t ru "%GDWORD%"

English -> German

• Name: aR En-De
• Command Line:

  "U:\voothi\20241121100211-argotranslate\venv\Scripts\python.exe" "U:\voothi\20241121100211-argotranslate\venv\Scripts\argos-translate" -f en -t de "%GDWORD%"

German -> Russian

• Name: aR De-Ru
• Command Line:

  "U:\voothi\20241121100211-argotranslate\venv\Scripts\python.exe" "U:\voothi\20241121100211-argotranslate\venv\Scripts\argos-translate" -f de -t ru "%GDWORD%"

German -> English

• Name: aR De-En
• Command Line:

  "U:\voothi\20241121100211-argotranslate\venv\Scripts\python.exe" "U:\voothi\20241121100211-argotranslate\venv\Scripts\argos-translate" -f de -t en "%GDWORD%"

Russian -> English

• Name: aR Ru-En
• Command Line:

  "U:\voothi\20241121100211-argotranslate\venv\Scripts\python.exe" "U:\voothi\20241121100211-argotranslate\venv\Scripts\argos-translate" -f ru -t en "%GDWORD%"

Russian -> German

• Name: aR Ru-De
• Command Line:

  "U:\voothi\20241121100211-argotranslate\venv\Scripts\python.exe" "U:\voothi\20241121100211-argotranslate\venv\Scripts\argos-translate" -f ru -t de "%GDWORD%"

Return to Top

Usage

Once configured:

1. Search for a word in GoldenDict-ng.
2. The configured "Programs" will appear as dictionary results, showing the translation from Argo Translate.

Return to Top

Kardenwort Ecosystem

This project is part of the Kardenwort environment, designed to create a focused and efficient learning ecosystem.

Return to Top

License

MIT