Skip to content

un-ts/deeplx

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DeepL Translate

GitHub Actions Workflow Status Codecov Codacy Grade type-coverage CodeRabbit Pull Request Reviews npm GitHub Release

Conventional Commits Renovate enabled JavaScript Style Guide Code Style: Prettier changesets

An unofficial Node package to translate text using DeepL by porting OwO-Network/DeepLX.

Online Service

https://deeplx.vercel.app/translate

Installation

# npm
npm i deeplx

# pnpm
pnpm add deeplx

# yarn
yarn add deeplx

# or install `@deeplx/core` for only API usage, or install `@deeplx/cli` for only CLI usage

Usage

Supported languages

Currently the following languages are supported:

Abbreviation Language Writing in own language
BG Bulgarian Български
ZH Chinese 中文
CS Czech Česky
DA Danish Dansk
NL Dutch Nederlands
EN English English
ET Estonian Eesti
FI Finnish Suomi
FR French Français
DE German Deutsch
EL Greek Ελληνικά
HU Hungarian Magyar
IT Italian Italiano
JA Japanese 日本語
LV Latvian Latviešu
LT Lithuanian Lietuvių
PL Polish Polski
PT Portuguese Português
RO Romanian Română
RU Russian Русский
SK Slovak Slovenčina
SL Slovenian Slovenščina
ES Spanish Español
SV Swedish Svenska
UK Ukrainian Українська Мова

You can either input the abbreviation or the language written in english.

Command line tool

Help

deeplx -h
Usage: deeplx [options]

The cli for [`@deeplx/core`](https://github.com/un-ts/deeplx/blob/master/packages/@deeplx/core).

Options:
  -V, --version        output the version number
  -s, --source <text>  Source language of your text
  -t, --target <text>  Target language of your desired text
  --text <text>        Text to be translated
  -f, --file <path>    File to be translated
  --formal [boolean]   Whether to use formal (true) or informal (false) tone in translation. Default `undefined` respects source text tone.
  --no-formal
  -h, --help           display help for command

Example 1

This will translate a Spanish (ES) text into Russian (RU):

deeplx -t russian --text "¡Buenos días!"
Доброе утро!

Example 2

This will translate the file (test.txt) text from Italian (IT) into Portuguese (PT):

deeplx -t PT -f test.txt

Example 3

This will translate a Spanish (ES) text into Russian (RU) in formal tone:

deeplx -t RU --text "¿Cómo te llamas?" --formal
Как Вас зовут?

Note: informal would be "Как тебя зовут?"

Example 4

This will translate a Japanese (JA) text into German (DE) in informal tone:

deeplx -t DE --text "お元気ですか?" --no-formal
Wie geht es dir?

Note: formal would be "Wie geht es Ihnen?"

Node library

Example 1

This will translate a Chinese (ZH) text into Dutch (NL):

import { translate } from 'deeplx'

await translate('你好', 'NL')
'Hallo'

Example 2

This will translate a danish text into german in informal tone:

import { translate } from 'deeplx'

await translate('Ring til mig!', 'german', 'danish', false)
'Ruf mich an!'

Sponsors

Sponsors

1stG RxTS UnTS
1stG Open Collective sponsors RxTS Open Collective sponsors UnTS Open Collective sponsors

Backers

1stG RxTS UnTS
1stG Open Collective backers RxTS Open Collective backers UnTS Open Collective backers

Changelog

Detailed changes for each release are documented in CHANGELOG.md.

License

MIT © JounQin@1stG.me