Skip to main content

A tiny command-line dictionary and translator implemented in Plumbum. and Google Translation API. Just for fun :)

Project description


PyPI version License: MIT

A command-line utility that can be used as:

  • A dictionary of Chinese and English word translation by getting the data of
  • A translator by using Google Translation API. You can also use it to detect the language type.

Just for fun :)


You can install dict-tiny via the pip package manager. (Python 3 only)

$ pip install dict-tiny


$ pip install --upgrade dict-tiny


Translate an English word or Chinese word

$ dict-tiny book
book  英[bʊk][bʊk]
n. 书籍;卷;账簿;名册;工作簿
vt. 预订;登记
n. (Book)人名;()(广东话·威妥玛)()北;()
$ dict-tiny 书
书  [shū]

Get more detail translation about the word

Use -m/--more to get more detail translation:

$ dict-tiny 曾经 -m
曾经  [céng jīng]

more detail:
======== 副词 ========
  (表示有过某些行为或情况) once:
  He once lived in Shanghai.
  She has taken part in a major battle for oil.
$ dict-tiny dictionary -m
dictionary  英['dɪkʃ(ə)n(ə)rɪ]美['dɪkʃə'nɛri]
n. 字典;词典

more detail (collins):
======== N-COUNT 可数名词 ========
 · 词典

A dictionary is a book in which the words and phrases of a language are listed alphabetically, together with their meanings or their translations in another language.

 例: ...a Spanish-English dictionary.


  • You can use -c and -m at the same time, which means get more detail translation about the word in clipboard.
  • Some words have a lot of translation that may occupy the entire screen.

Using Google Translation API

Adding -g to use Google Translation API:

$ dict-tiny -g book
detectedSourceLanguage: en
input: book
translatedText: 书

Adding --target-language to specify what language you want to translate into:

$ dict-tiny -g book --target-language japanese
detectedSourceLanguage: en
input: book
translatedText: 本

Adding --source-language to specify what language you want to translate, but most of the time you don't need to do this because the api will automatically detect the language type.

So, of course, you can use it to detect the language type:

$ dict-tiny --detect-language book
confidence: 1
input: book
language: en
name: Armenian


  • Setting the environment variable $DICT_TINY_TARGET_LAN to the target language you prefer so that you do not have to specify the target language every time. Dict-tiny will first get target language from $DICT_TINY_TARGET_LAN. Giving the --target-language switch on the command line will override the environment variable value.

  • If your input is a sentence or more than one word, the Google Translation API will be called automatically. In other word, you don't need to manually add -g when you type a sentence.

  • The source and target languages are identified using the iso-639-1 codes.

    $ dict-tiny -g book --target-language zh --source-language en
    input: book
    translatedText: 书

    You can also enter the ISO language name:

    $ dict-tiny -g book --target-language chinese --source-language english
    input: book
    translatedText: 书

Translate the word in clipboard

Use -c/--clipboard to translate the word in clipboard:

$ dict-tiny -c
command line

If you want to use -g you need to put it before -c.

$ dict-tiny -g -c
detectedSourceLanguage: en
input: clipboard
translatedText: 剪贴板


  • -c/--clipboard has high priority. If you add -c and a word at the same time, the word will be ignored.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for dict-tiny, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size dict_tiny-0.3.0-py3-none-any.whl (10.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size dict-tiny-0.3.0.tar.gz (9.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page