Language Translator

An Obsidian plugin to translate selected text in the desired language.

Report a Bug · Request a Feature

Language Translator

An Obsidian plugin to translate selected text in the desired language.

About The Project

This plugin allows you to translate selected text into the desired language. It's based on a free instance of Azure Translator. Please do not abuse it :)

Word of advice

Keep in mind this is an initial version and that the plugin interface is subject to change! PS: If you have recommendations please see the Contributing section

Installing

Find this plugin in the listing of community plugins in Obsidian and add it to your application.

Or, if you'd like to install it manually, clone this repository to the .obsidian/plugins/ directory in your vault, navigate to your newly cloned folder, run npm i or yarn to install dependencies, and run npm run build or yarn build to compile the plugin.

Settings

The plugin allows for certain types of configuration:

Target Language

Here we select what is the default target for our translation.

API Type

The plugin allows choice between the Builtin Azure API (limited version) and your own hosted services in Azure or LibreTranslate.

Azure Translator region

This setting is to allow you to set up your own Azure Translator instance with your predefined region. The default Azure region used by the builtin API is global

API Url

This is to distinguish between the default Azure API Url and other possible hosting locations

API Token

This token is required only for privately hosted instances of Azure or LibreTranslate

1. Sign in to the Azure portal.
2. Navigate to your Azure Cognitive Services resource.
3. In the left-hand menu, select "Keys and Endpoint".
4. Find your API keys listed under "Key1" and "Key2".

Usage

1. First you need to define the text to be translated. There are two options available:

   • By explicitly specifying the language code

     fr:I want to break free
     

     First part is the prefix containing the language code (See codes here). The second part is the actual text for translation.

   • Or directly, using the default source language code in the settings.

     I want to break free
     

2. Select the text

3. Execute the translation by

   • Hitting Ctrl+P and executing the Language Translator: Insert translation command
   • or by using the predefined hotkey (default is Ctrl+Shift+R)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

License

This project is licensed under the MIT License - see the LICENSE file for details

Contact

Florin Bobis - @twentytwokhz - [email protected]

Project Link: https://github.com/twentytwokhz/language-translator