Find synonyms in 15 different languages directly from your terminal.

synonym

Find synonyms in 15 different languages directly from your terminal.

synonym is a small utility tool to rapidly find synonyms directly from your terminal.

The script is querying the thesaurus.com API.

List of languages supported:

en, fr, cs, el, es, da, de, hu, it, no, pl, pt, ro, ru, sk

What do you need?

Thesaurus API key

You will need to generate an API key to use this script, you can do so at https://thesaurus.altervista.org/mykey
You can sign in with either Facebook, Google or Yahoo.
After the sign in process you will be redirected you to your API key.
You then need to store your API key in your .synonymrc file.

jq

You will also need to install jq if you don't have it already https://stedolan.github.io/jq/download/

brew install jq          # macos
sudo apt-get install jq  # debian / ubuntu

How to install it?

Clone this repository and run the following commands.

git clone https://github.com/smallwat3r/synonym.git \
  && cd synonym \
  && make install

or

git clone https://github.com/smallwat3r/synonym.git \
  && cd synonym \ 
  && cp synonym /usr/local/bin/synonym && chmod 755 /usr/local/bin/synonym

or (without cloning)

sudo wget https://raw.githubusercontent.com/smallwat3r/synonym/master/synonym \
    -P /usr/local/bin && sudo chmod 755 /usr/local/bin/synonym

.synonymrc

You will need to create a .synonymrc config file in one of the location below.

# Possible config file locations (in order of priority)

$XDG_CONFIG_HOME/.synonymrc
~/.config/.synonymrc
~/.synonymrc

In this file, you can chose a default language and you will need to input your API key from thesaurus.

# .synonymrc example

# API KEY https://thesaurus.altervista.org/mykey
SYNONYM_THESAURUS_KEY=<API KEY>

# Default language
# List of languages available:
#   en, fr, cs, el, es, da, de, hu,
#   it, no, pl, pt, ro, ru, sk
SYNONYM_SEARCH_LANG=en

Note: if no language is set in .synonymrc, or specified in parameters, the default language will be fetched from the os ($LANGUAGE or $LANG). If not supported by Thesaurus, or null, it will be set as default to en_US.

You are now all set-up to run synonym in your terminal.

How to use it?

$ synonym -u
Usage: synonym [OPTION] WORD
Finds all synonyms for a specific word in a specified language.

Options:
  -l LANG      Finds all synonyms for this specific language.
               Languages supported: en, fr, cs, el, es, da, de,
               hu, it, no, pl, pt, ro, ru, sk
  -h           Show help message and exit.
  -u           Show usage and exit.
  -v           Show program version number and exit.

Examples

synonym happy
synonym -l en happy
synonym -l fr joyeux
synonym -l it allegro 
synonym -l de fröhlich