Skip to content

Latest commit

 

History

History
85 lines (53 loc) · 3.44 KB

README.md

File metadata and controls

85 lines (53 loc) · 3.44 KB

jDeepL

Unofficial DeepL App / GUI for Linux based on JavaFX.

Developed and tested on openSUSE Tumbleweed, KDE Plasma and OpenJDK 11.

REUSE status

Table of Content

Requirements

Due to the fact that this is an unofficial client which use the regular DeepL API, you need a own API Key.

DEEPL API FREE is already sufficient and provides a 500,000 character limit per month at no cost, which should be enough for personal use.

Features

Limited feature set and just a simple optic compared to the official Windows or Mac App.

jDeepL supports the Free and Pro Version of the DeepL API, the correct API URL will be picked automatically based on the entered API Key.

The Shortcut CTRL + C + C, similar to the DeepL Windows App, will:

  • Copy the selected text
  • Restore the jDeepL Window if it's minimized or not in Focus
  • Paste the earlier copied text
  • Trigger the Translation

Releases

There is no automated release process in place yet, I'm also still testing the most suitable packaging and Distribution format.

For the time being, I'm going to manually publish new releases on my personal Nextcloud instance: https://hub.xlii.cc/s/an7E9E9bgFBpRG3

Latest version: v0.7.4 (SHA256 checksum: 206c13ec820451096bdf07f29e336c6827c750db11554d9dcc68812c8b56c796)

Build

Clone the repository from your preferred location (Primary: sourcehut / Mirror: codeberg, gitlab, github).

To build the code, ensure you have a SDK in version 11 installed, you can use the package manager of your Linux Distribution or try sdkman.

You also need Apache Maven, either use the manual installation method, your package manager or the version shipped with your IDE.

The Project is pre-configured to compile a fat jar file by running mvn compile package. This command will create the file shade/jDeepL.jar, to launch jDeepL run java -jar shade/jDeepL.jar.

You can for sure also copy the .jar file to any other location you prefer and run it from there.

Contribution

The primary location of the Source Code is: https://git.sr.ht/~wombelix/jDeepL

Mirrors of the repository are available on Codeberg, Gitlab and Github.

Please don't hesitate to provide Feedback, open an Issue or create an Pull / Merge Request.

Just pick the workflow or platform you prefer and are most comfortable with.

Feedback, Bug Reports or Patches via Email are also always welcome.

License

Unless otherwise stated: GNU General Public License v3.0 or later

All files contain license information either as header comment or corresponding .license file.

REUSE from the FSFE implemented to verify license and copyright compliance.