Metadata-Version: 2.1
Name: cli-translate
Version: 0.0.5
Summary: Useful translation tool for console. With features: translate text from clipboard and store translation logs
Home-page: https://github.com/Insolita/cli_translate
Author: Insolita
Author-email: webmaster100500@ya.ru
License: MIT
Download-URL: https://github.com/Insolita/cli_translate/tarball/master
Keywords: translation,translate,yandex,google,google translate,clipboard,notify-send,console
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.4
Description-Content-Type: text/markdown
Requires-Dist: pyperclip (>=1.5.27)
Requires-Dist: requests (>=2.18)
Requires-Dist: pyquery (>=1.2.9)

Console Translator
==================

### Installation

`pip3 install cli_translate --user`


### Features

 - Quick translation for text in clipboard

 - Ability for replace text in clipboard with translation

 - Ability for output with notify-send (useful with hotkey binding)

 - Store all translated texts in sqlite database

 - Google or Yandex translation clients 

### Configure Yandex Api key

The usage yandex translator require following steps

   - go to https://translate.yandex.ru/developers/keys and register free api key

   - define environment variable with name YANDEX_TRANSLATE_API_KEY and with api key as value [Guide](https://wiki.archlinux.org/index.php/environment_variables)


 ### Usage Examples

  - `itrans -to es`  Clipboard text will be translated

  - `itrans -to fr "Some text"`  "Some text" will be translated

  - `itrans -to en -i` Interactive text input mode

  - `itrans -to en -p` Clipboard text will be translated and replaced with translation

  - `itrans --help`  See All available options


 ### Tips and Tricks
  - register bash/zsh aliases with most useful options; example `alias et="itrans -to en -p -o -c yandex"

  - save translation to file `itrans [options] > file.txt`

  - translate text from file `itrans [options] "$(cat /path/to_file.txt)"`

  - pipe result to another `itrans --raw "Hello World"|cowsay`

### Limitations

This utility is for personal use, not automated translations. 

The volume of translated text lenght  is limited per-request

### Screens

![Screen1](./img/cli1.png)

![Screen2](./img/cli2.png)

![Screen3](./img/cli3.png)


