https://github.com/octoober/anki-translator

Translates the selected field in all Anki cards
https://github.com/octoober/anki-translator

anki anki-deck anki-flashcards

Last synced: about 2 months ago
JSON representation

Translates the selected field in all Anki cards

• Host: GitHub
• URL: https://github.com/octoober/anki-translator
• Owner: Octoober
• Created: 2025-02-27T20:56:12.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-01T08:33:24.000Z (over 1 year ago)
• Last Synced: 2025-03-01T09:18:24.353Z (over 1 year ago)
• Topics: anki, anki-deck, anki-flashcards
• Language: Python
• Homepage:
• Size: 58.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Anki Translator 🀄

Автоматизирует перевод указанных полей в карточках Anki.



---

## 🌟 Особенности

- **Гибкая настройка** через `config.json`

- Поддержка **вложенных колод** (например, `"deck_name": "Wanikani Ultimate::Vocabulary"`)

- Пакетный перевод нескольких полей за один запрос

- Прогресс сохраняется в _translation_progress.json_ для возобновления работы

- Поддержка Google Translate, DeepSeek и OpenAI

---

## 🧬 Требования

1. [Anki](https://apps.ankiweb.net/) с установленным плагином **[AnkiConnect](https://ankiweb.net/shared/info/2055492159)**  

   _Установка плагина:_  

   `В Anki: Tools → Add-ons → Get Add-ons → Введите код 2055492159`

---

## 👾 Установка

```bash

# 1. Клонируйте репозиторий

git clone https://github.com/ваш-логин/anki-translator.git

# 2. Установите зависимости

pip install -r requirements.txt

```

---

## 🔧 Конфигурация

Создайте `config.json` в корне проекта по образцу:

```

{

  "anki_connect_url": "http://localhost:8765",

  "deck_name": "Моя колода::Подколода",

  "target_fields": ["Поле1", "Поле2"],

  "source_lang": "en",

  "target_lang": "ru",

  "request_delay": 20,

  "max_retries": 3,

  "translation_service": {

    "service": "google",

  }

}

```

- Доступные сервисы:

  - OpenAI

  - DeepSeek

  - Google Translate (не требует API-ключа)

Для использования OpenAI или DeepSeek:

```

  ...

  "translation_service": {

    "service": "deepseek",

    "api_key": "ваш_api_ключ",

    "model": "gpt-3.5-turbo"

  }

```

---

## ⚠️ Рекомендации

1. **Создайте резервную копию** колоды перед использованием

2. Для полей с HTML-разметкой используйте нейронки

3. При ошибках:

   - Увеличьте `request_delay` в конфиге

   - Убедитесь, что AnkiConnect запущен