Home

Awesome

📚 vocabs

<p align=center> <img src="./asset/dict.jpg" width="400"/> <br> <a target="_blank"><img src="https://img.shields.io/badge/platform-linux-lightgrey.svg"></a> <a target="_blank" href="https://www.python.org/downloads/" title="Python version"><img src="https://img.shields.io/badge/python-%3E=_3.6-green.svg"></a> <a target="_blank" href="https://opensource.org/licenses/MIT" title="License: MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg"></a> <a target="_blank" href="http://makeapullrequest.com" title="PRs Welcome"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg"></a> <a target="_blank"><img src="https://img.shields.io/badge/status-adding features-red.svg"></a> </p>

📚 A lightweight online dictionary integration to the command line. No browsers. No paperbacks.


<p align=center><img src="./asset/gifs/demo.gif" width="1000"/></p>

Setting Up

$ pip install vocabs

Features

📆 Word of the Day!

📈 Trending words!

❓ Directly query words from the command line.

📓 Save words to your local dictionary.

📝 Add notes to saved words.

🎮 Interactive word game to hone your vocabulary skills.

So how is this different from dict ?

<p align=center> <img src="./asset/gifs/dicthello.gif" width="400"> <img src="./asset/gifs/vocabhello.gif" width="400"> </p>

dict is the client for DICT, or the Dictionary Server Protocol on Unix-like platforms. It is used to query natural language dictionaries without firing up a bloaty browser, which tremendously slows down your workflow.

Vocab aims to do the same as dict, only with some differences:

All in all, Vocab is a great tool for fast word queries with easy-to-read definitions, and a good support for ESL users.

Requirements

<a target="_blank" href="https://www.python.org/downloads/" title="Python version"><img src="https://img.shields.io/badge/python-%3E=_3.6-green.svg"></a> and the following libraries are required.

<a target="_blank"><img src="https://img.shields.io/badge/python-beautifulsoup4%20%7C%20requests%20%7C%20termcolor-blue.svg">

<a target="_blank"><img src="https://img.shields.io/badge/platform-linux-lightgrey.svg"></a> <a target="_blank"><img src="https://img.shields.io/badge/python-tty%20%7C%20termios-blue.svg"></a>

Running

🔥 Launch vocab anywhere on your terminal.

$ vocab

Usage

$ vocab

Options:
    --mode, -m ['query', 'edit', 'dict', 'interactive']
    --file, -f <path to word list>
    --reset, -r
    --count, -c
    --lucky, -l
    --trend, t

Feeling Lucky

📆 Word of the Day.

$ vocab -l
<img src="./asset/gifs/lucky.gif" width="600"/>

Trending Words

📈 Shows a list of frequently searched words.

$ vocab -t
<img src="./asset/gifs/trending.gif" width="600"/>

Query Mode

❓ Directly search and save unknown words from the command line.

$ vocab -m query
<img src="./asset/gifs/query.gif" width="600"/>

Dictionary Mode

📓 Scroll though pages to search for saved words.

$ vocab -m dict
<img src="./asset/gifs/dict.gif" width="600"/>

Edit mode

✏️ Edit your save words and add notes.

$ vocab -m edit
<img src="./asset/gifs/edit.gif" width="600"/>

Interactive Mode

🎮 Test your vocabulary skills with the interactive mode.

$ vocab -m interactive
<img src="./asset/gifs/interactive.gif" width="600"/>

Load Word List

📜 Load a list of words from to your local dictionary.

$ vocab -f <path to file>
<img src="./asset/gifs/file.gif" width="600"/>

Count Total Words

🔢 Count number of words saved in your local dictionary.

$ vocab -c
<img src="./asset/gifs/count.gif" width="600"/>

Reset Local Dictionary

$ vocab -r

Help

$ vocab -h

Todo