Metadata-Version: 2.1
Name: cli-translate
Version: 0.0.3
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 License
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
Requires: python (>= 3.0)
Requires: pyperclip (>= 1.5.27)
Requires: requests(>=2.18, <=3.0.0)
Requires: 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

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

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

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

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

  - `itranslate --help`  See All available options


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

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

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

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

### Limitations

This utility is for personal use, not automated translations. 

The volume of translated text lenght  is limited per-request

