deepl translate via pyppeteer
pip install deepl-tr-pp
To update to the latest version:
pip install deepl-tr-pp -U
# poetry add deepl-tr-pp@latest # if you use poetry
or clone the github repo, install and run from the source
git clone clone https://github.com/ffreemt/deepl-tr-pyppeteer
cd deepl-tr-pyppeteer
pip install poetry
poetry install --no-dev
poetry run python -m deepl_tr_pp # equivalent to executing `deepl-tr-pp` below
Languages supported: ["en", "de", "zh", "fr", "es", "pt", "it", "nl", "pl", "ru", "ja"]
(currently supported by the website)
Input file formats currently supported: txt and docx, files with other suffix (e.g., .csv, .tsv) will simply be treated as text.
To interrupt anytime: Ctrl-c
. The first few versions may not run too smoothly. If it hangs, press control
and c
at the same time to exit.
deepl-tr-pp -p file.txt # en to zh, default en to zh, dualtext output, docx format
deepl-tr-pp -p file.txt -f de # de to zh
deepl-tr-pp -p file.txt -f de -t en # de to en
deepl-tr-pp # browse for a file, en to zh
deepl-tr-pp --copyfrom # text from the clipboard, en to zh
deepl-tr-pp -p file.txt --nodualtext # en to zh, default en to zh, just translated text (no dualtext)
deepl-tr-pp -p file.txt --nooutput-docx # default en to zh, dualtext, text format
By default, the text version of the output is copied to the clipboard, turn this off by --nocopyto
deepl-tr-pp -p file.txt --nocopyto
To show the browser in action or set debug or proxy, create an .env
file and set the corresponding environ variables (these can also be set from the command line, e.g., set DEEPLTR_HEADFUL=true
(in Windows) or export DEEPLTR_HEADFUL=true
(in Linux) ):
# .env
DEEPLTR_HEADFUL=true
DEEPLTR_DEBUG=true
# DEEPLTR_HEADFUL=True
# DEEPLTR_HEADFUL=tRue # also works
# DEEPLTR_HEADFUL=False
# DEEPLTR_HEADFUL=fAlse
# DEEPLTR_HEADFUL=1
# DEEPLTR_HEADFUL='1'
# must use capitals
# DEEPLTR_PROXY=SOCKS5://127.0.0.1:1080
deepl-tr-pp --helpshort
--[no]copyfrom: copy from clipboard, default false, will attempt to browser
for a filepath if copyfrom is set false)
(default: 'false')
--[no]copyto: copy the result to clipboard
(default: 'true')
--[no]debug: print debug messages.
(default: 'false')
-d,--[no]dualtext: dualtext or no dualtext output
(default: 'true')
-p,--filepath: source text filepath (relative or absolute), if not provided,
clipboard content will be used as source text.
(default: '')
-f,--from-lang: source language, default english)
(default: 'en')
-o,--[no]output-docx: output docx or text
(default: 'true')
-t,--to-lang: target language, default chinese
(default: 'zh')
--[no]version: print version and exit
(default: 'false')
or
deepl-tr-pp --helpfull
-
Install
poetry
the way you like it. -
git clone the repo
https://github.com/ffreemt/deepl-tr-pyppeteer
,cd deepl-tr-pyppeteer
- Or fork first and
git pull
your own repo.
- Or fork first and
-
poetry install
-
Activate the virtual environment, e.g.,
.venv\Scripts\activate
(In Windows) orsource .venv/bin/activate
(in Linux) provided you setpoetry config --local virtualenvs.in-project true
python -m deepl_tr_pp
-
Code and optionally submit PR