Skip to content

ethanbaker/epick

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

1.0.0 GoDoc Go Report Card Contributors Forks Stargazers Issues License LinkedIn




Epick

A simple emoji picker for the terminal

Table of Contents
  1. About
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact

About

Project demonstration image

Epick was designed to reduce the hassle of having to search up the copy and paste for different emojis whenever you want an emoji in a text document. For instance, adding emojis to blog posts in the terminal can be so much easier when using Epick, as you no longer need to copy and paste a character after searching for the perfect emoji for 5 minutes. All you need to do is run the epick command, find the preferred emoji, and continue coding!

(back to top)

Built With

(back to top)

Getting Started

In order to download and start using epick as a terminal command, you must first clone the git repository to your local system.

In order to use epick in a different application, import it by using the import statement: import "github.com/ethanbaker/epick"

Prerequisites

  • Go is installed
  • Your terminal is able to render emojis

Installation

  1. Clone the repository (git clone git@github.com:ethanbaker/epick.git)
  2. Navigate into the cloned directory
  3. Run go install

Epick should now be installed!

(back to top)

Usage

Epick contains multiple pages of different emojis, each of which represents a unique emoji category. These categories are:

  • Smileys and Emotion
  • People and Body
  • Animals and Nature
  • Food and Drink
  • Travel and Places
  • Activities
  • Objects
  • Symbols
  • Flags

You can navigate between different emojis using standard vim bindings (j, j, k, l, g, G).

You can switch between emoji categories by pressing 'C' to go forwards and 'c' to go backwards.

You can quit the app by pressing 'q' or Escape.

You can search for emojis by pressing '?'. This brings up a menu where emojis can be searched for with autocomplete. If you enter a partially incomplete phrase, you can navigate between matching emojis by pressing 'n' to go forwards and 'N' to go backwards.

(back to top)

Roadmap

  • Documentation
  • Quality-ensurance Refactor
  • Testing

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

For issues and suggestions, please include as much useful information as possible. Review the documentation and make sure the issue is actually present or the suggestion is not included. Please share issues/suggestions on the issue tracker.

For patches and feature additions, please submit them as pull requests. Please adhere to the conventional commits. standard for commit messaging. In addition, please try to name your git branch according to your new patch. These standards are a great guide you can follow.

You can follow these steps below to create a pull request:

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b branch_name)
  3. Commit your Changes (git commit -m 'commit_message')
  4. Push to the Branch (git push origin branch_name)
  5. Open a Pull Request

(back to top)

License

This project uses the Apache 2.0 license.

You can find more information in the LICENSE file.

(back to top)

Contact

Ethan Baker - contact@ethanbaker.dev - LinkedIn

Project Link: https://github.com/ethanbaker/epick

(back to top)

(back to top)