https://github.com/rapha149/ulauncher-deepl
A powerful DeepL translator for Ulauncher.
https://github.com/rapha149/ulauncher-deepl
deepl translate ulauncher ulauncher-extension
Last synced: 5 months ago
JSON representation
A powerful DeepL translator for Ulauncher.
- Host: GitHub
- URL: https://github.com/rapha149/ulauncher-deepl
- Owner: Rapha149
- License: gpl-3.0
- Created: 2022-04-15T18:20:01.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-26T12:02:51.000Z (about 1 year ago)
- Last Synced: 2024-12-26T13:23:15.808Z (about 1 year ago)
- Topics: deepl, translate, ulauncher, ulauncher-extension
- Language: Python
- Homepage: https://ext.ulauncher.io/-/github-rapha149-ulauncher-deepl
- Size: 67.4 KB
- Stars: 10
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DeepL for Ulauncher
A powerful DeepL translator for Ulauncher.
## Features
- Translate text (kinda obvious)
- Quickly translate to the last used languages
- Use `from:to` in front of the text to choose languages even quicker! (See [Quick Language Selection](#quick-language-selection))
- Many options to customize the translator! (See [Preferences](#preferences))
- Copy the result to clipboard, translate it into another language or use the same input text again by pressing one button!
- Up to 500000 characters per month for free! (DeepL limitations)
## Requirements
`pip install deepl`
## Get an API key
You can get an DeepL API key for free at https://www.deepl.com/pro-api
With free API keys you can translate up to 500000 characters per month.
Of course you can also buy an API key and get more characters if needed.
## Quick Language Selection
Using the pattern `from:to` in front of the to be translated text you can quickly select the languages.
For example: `en:es` to translate from English to Spanish.
You can also specify `auto` and `select` for the source language and `select` for the target language.
If using `auto` the translator will automatically detect the source language.
If using `select` you will be able to select the source/target language respectively.
This is useful when you have selected languages in the preferences. Using this method you can temporarily "set" these settings to `auto` or `select`.
If you don't know a language code you can specify anything. The extension will tell you it doesn't know that language code and offer you a list of codes.
## Preferences
**Keyword**
The keyword to use the extension.
Defaults to `tr`.
**API key**
Your DeepL API key. See [Get an API key](#get-an-api-key).
**Source language**
The language you want to translate from.
Set to `auto` to let DeepL detect the language automatically.
Set to `select` to select the language manually each time.
Set to a language code to always use that language. If you don't know the language code enter something else.
Then the extension will tell you that it doesn't know that language code and offer you a list of codes.
Defaults to `select`.
**Target language**
The language you want to translate to.
Set to `select` to select the language manually each time.
Set to a language code to always use that language. If you don't know the language code enter something else.
Then the extension will tell you that it doesn't know that language code and offer you a list of codes.
Defaults to `select`.
**Number of quick access languages**
Specifies how many languages to translate to are displayed for quick access.
This setting applies only when `Target language` is set to `select`.
Defaults to `3`.
**Number of languages per page**
Specifies how many languages are displayed per page.
Defaults to `10`.
**Split result in lines every `n` characters**
Specifies after how many characters the result text is split into multiple lines.
Words won't be split.
Set to `0` to disable splitting. Warning: Large translated texts won't be displayed in full.
Defaults to `65`.
**Formality of translated text**
Specifies the formality of the translated text if available for the target language.
Available options: `default`, `less` and `more`.
Defaults to `default`.