😱 Emoji completion on the command line
Shell
Latest commit 5179c1e Oct 31, 2016 @b4b4r07 committed on GitHub Merge pull request #8 from krokofant/patch-1
Add Homebrew dependency install instruction

README.md

emoji-cli provides input completion for emoji on the command line with an interactive filter.

πŸ“ Description

Emoji (η΅΅ζ–‡ε­—, Japanese pronunciation: [emodΚ‘i]) are the ideograms or smileys used in Japanese electronic messages and Web pages, that are spreading outside Japan (ref: Katy Perry - Roar (Lyric Video)).

Emoji are funny and make us want to use it 😊. However, it is hard to use it on the command line. This is because the command line don't have input completion for emoji. Therefore, I developed this command line application emoji-cli.

DEMO:

:trollface: Features

  • 😱 Emoji on the command line
  • 🌐 Interactive filter
  • πŸ”Ž Fuzzy search

Unfortunately, this application supports Z shell only now πŸ™‡.

πŸ” Usage

To insert emoji to the command line, type ctrl-s ( ^s ).

$ git commit -m 'This docume^s ...

To collaborate emojify similar to emoji-cli in emoji appication:

echo ":santa^s" | emojify
πŸŽ…

πŸ“¦ Installation

$ git clone https://github.com/b4b4r07/emoji-cli
$ source ./emoji-cli/emoji-cli.zsh

For zplug user:

$ zplug "b4b4r07/emoji-cli"

Dependencies

🍺 Using Homebrew

On macOS you can install the dependencies via Homebrew:

brew install jq fzf peco

πŸ”§ Setup

EMOJI_CLI_DICT

It is defaults to ./dict/emoji.json. EMOJI_CLI_DICT is a path to dictionary of emoji database file. It is written in JSON.

EMOJI_CLI_FILTER

It is defaults to fzf-tmux -d 15%:fzf:peco:percol. EMOJI_CLI_FILTER is the interactive filter command in order to use select emoji. It is separated by colon like the PATH environment variable.

EMOJI_CLI_KEYBIND

It is defaults to ^s (ctrl-s). EMOJI_CLI_KEYBIND is the key binding to start the input completion for emoji.

🎫 License

MIT Β© BABAROT (a.k.a. b4b4r07)