DeepL-and-Google-Translator

<img width="1055" alt="スクリーンショット 2025-05-11 17 28 35" src="https://github.com/user-attachments/assets/d97d4cfa-682f-4bf7-9884-f68bb311affa" />

Demo

What is it?

• This is the Translator Anki Add-on.
• 🔀 You can switch between DeepL Translate and Google Cloud Translate.
• 🕵️ You can track your API usage.
• 🔑 You need a Google Cloud API Key or DeepL API Key.
• ✅ It is completely free to use within the limits specified by each API.

How to Use

<img width="492" alt="スクリーンショット 2025-05-13 17 05 16" src="https://github.com/user-attachments/assets/8a8b6b9d-7b61-466f-9ee1-e8ffd5eb63d5" /><br> <img width="389" alt="スクリーンショット 2025-05-12 17 03 56" src="https://github.com/user-attachments/assets/a96be101-ec51-4d15-8d5d-966f0ab77a18" />

1. Go to Tools > D and G Translator
2. Set up your fields:
   • Source Field is the field that contains the text to translate.
   • Target Field is the field where the translated text will be inserted.
   • ⚠️ This is a general setting. You can also configure settings per deck. See the Per-Deck Settings section for details.
3. Target Language is the language that will be inserted into the Target Field.
   • Example: If you want to translate from English to Japanese, set the target language to Japanese.
4. Insert your DeepL or Google Cloud API Key.
5. If you're using DeepL, setting the API start date allows accurate usage tracking.
6. Turn on Safe Mode to disable translation when API usage exceeds the limit.
7. While adding or browsing cards, click the D & L Translator button to translate:
   • In DeepL mode, the DeepL icon appears.
   • In Google Cloud mode, the Google icon appears.

Per-Deck Settings

• Click Setting Button the button next to the D and L Translator icon in the Browser or Add screens to configure settings specific to each note type.
• These settings override the general settings and are recommended for accurate translation behavior.

Translate Multiple Languages

• You can translate multiple languages at once via
  Browser > Edit > Translate Multiple Words - D and G Translator. <img width="1086" alt="スクリーンショット 2025-05-13 17 06 22" src="https://github.com/user-attachments/assets/2830ff4c-4203-4982-955d-4ac04137fbef" />

FAQ

• Q: Translation doesn’t work.
  A: Make sure the correct API Key and translation mode are selected.

• Q: The text isn't being translated to the correct field or language.
  A: Check the settings under the Per-Deck Settings section to ensure everything is properly configured.

⚠️⚠️⚠️Very Important Notice⚠️⚠️⚠️

• The API Usage feature is an experimental function.
• API Usage reflects only the amount used within this app.
• API Usage may not always be accurate. Please use it at your own risk.

Please Rate👍

• Rate this add-on 👍👍👍👍👍👍
• Star this project ⭐️⭐️⭐️⭐️⭐️⭐️

LICENSE

This add-on is distributed under the Apache License 2.0.

Third-party Licenses

• Icons: Some icons are provided by Icons8.
  Icons8 icons are used in accordance with their Terms of Service.

• DeepL Python Library:
  This add-on uses the deepl-python library, which is licensed under the MIT License.

• Google API Python Client:
  This add-on uses the google-api-python-client, which is licensed under the Apache License 2.0.

• dateutil:
  This add-on uses python-dateutil, which is licensed under the BSD 3-Clause License.

Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

Copyright (c) 2025 [omuomuMG]

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.