ffreemt / xtl-read-assistant

xtl-read-assistant

x as a third language reading assistant tool

Pre-installation of libicu

For Linux/OSX

E.g.

• Ubuntu: sudo apt install libicu-dev
• Centos: yum install libicu
• OSX: brew install icu4c

Then install pyicu, pycld2 and morfessor, e.g.,

  pip install pyicu pycld2 morfessor

For Windows

Download and install the pyicu, pycld2 and morfessor whl packages for your OS and Python versions from https://www.lfd.uci.edu/~gohlke/pythonlibs/#pyicu and https://www.lfd.uci.edu/~gohlke/pythonlibs/#pycld2 and https://www.lfd.uci.edu/~gohlke/pythonlibs/#morfessor e.g.

pip install pyicu...whl pyicld2....whl morfessro...whl

Installation

pip install xtl-read-assistant```

Validate installation
```python
python -c "import xtl_read_assistant; print(xtl_read_assistant.__version__)"
# 0.0.2 or other version info

Patch pyppeteer/connection.py

This is no longer necessary. But make sure an updated version of deepl-tr-async is used (at least 0.0.3, deepl-tr-async 0.0.3 and up uses pyppeteer2). E.g.

pip install deepl-tr-async -U

If for some reason you have to use pyppeteer istead of pyppeteer2, do this patch https://github.com/miyakogi/pyppeteer/pull/160/files

( xtl-read-assistant relies on deepl-tr-async which in turn relies on pyppeteer that again replies on websockets. pyppeteer, however, does not play well with new versions of websockets 8.x. Hence, either downgrade websockts to 6.x or patch manually according to https://github.com/miyakogi/pyppeteer/pull/160/files or use pyppeteer2)

Usage

Run read-assist.exe; Copy text to the clipboard (ctrl-c); Activate hotkey (ctrl-alt-g)

The translated text is stored in the clipboard.

default setup: --mother-lang=zh --second-lang=en --third-lang=de

read-assist

ctrl-alt-g: to activate clipboard translation ctrl-alt-x: to exit

other setup exmaple: --mother-lang=zh --second-lang=en --third-lang=fr

read-assist --third-lang=fr