gemoji-cli
🚧 This project is under active development 🚧
A command-line interface for converting emoji codes to Unicode characters and listing available emojis. Built on top of GitHub's gemoji library, this tool provides an easy way to work with emojis in your terminal.
Features
- 🔄 Convert GitHub-style emoji codes (
:emoji_name:
) to Unicode characters - 📄 List all available emojis in Markdown or CSV format
- 💻 Cross-platform support
Installation
gem install gemoji-cli
Usage
Filter Emoji Codes
Convert emoji codes in standard input to Unicode characters:
echo "Hello :smile: :wave:" | gemoji filter
# Output: Hello 😊 👋
This will convert all valid emoji codes (:emoji_name:
) to their corresponding Unicode characters. Custom emoji codes will remain unchanged.
List All Emojis
Display all available emojis:
gemoji list
By default, this will output a Markdown-formatted table:
| Name | Raw |
|------|-----|
| :smile: | 😊 |
| :wave: | 👋 |
...
You can also get the output in CSV format:
gemoji list --format=csv
This will output:
Name,Raw
:smile:,😊
:wave:,👋
...
Development
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
.
Contributing
- Fork it
- Create your feature branch (
git checkout -b feature/my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin feature/my-new-feature
) - Create a new Pull Request
Bug reports and pull requests are welcome on GitHub at https://github.com/sakuro/gemoji-cli.
License
The gem is available as open source under the terms of the MIT License.