https://github.com/zeenix/gimoji

Easily add emojis to your git commit messages 😎
https://github.com/zeenix/gimoji

Last synced: 2 months ago
JSON representation

Easily add emojis to your git commit messages 😎

• Host: GitHub
• URL: https://github.com/zeenix/gimoji
• Owner: zeenix
• License: mit
• Created: 2023-05-21T13:33:58.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-03-26T08:14:16.000Z (9 months ago)
• Last Synced: 2024-03-26T09:30:34.400Z (9 months ago)
• Language: Rust
• Homepage:
• Size: 2.18 MB
• Stars: 25
• Watchers: 2
• Forks: 8
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE-MIT

Awesome Lists containing this project

• awesome-ratatui - gimoji - Makes it easy to add emojis to your Git commit messages. (💻 Apps / ⌨️ Development Tools)

README

        
# gimoji

[![Build Status](https://github.com/zeenix/gimoji/actions/workflows/rust.yml/badge.svg)](https://github.com/zeenix/gimoji/actions/workflows/rust.yml)

![./screencast](screencast.gif)

A CLI tool that makes it easy to add emojis to your git commit messages. It's very similar to (and

is based on) [gitmoji-cli] but written in Rust.

## Installation

### Fedora (>= 37)

```bash

sudo dnf install gimoji

```

### Other OSes

```bash

cargo install -f gimoji

```

## Usage

`gimoji` is primarily intended to be used as a git `prepare-commit-msg` hook. Once installed, ask

`gimoji` to install the hook in your repository:

```bash

cd /path/to/your/project/

gimoji --init

```

Now, whenever you run `git commit`, `gimoji` will kick in and prompt you to choose an emoji.

If you launch `gimoji` directly without any arguments, it will prompt you to choose an emoji and

then copy your choice to the system clipboard.

Use `--help` to see all the available options.

## Rationale

[gitmoji-cli] while being a great tool, can be considerably [slow]. Hence this project. `gimoji` has a

few differences:

* it will launch a full-screen terminal UI to choose an emoji, hence emojis on the console.

* it will only add an emoji prefix to the commit if one is not already present in the commit

  message (e.g when using  `-m` option of `git commit`, or when amending a commit).

* it does not add anything other than an emoji (like scope, summary etc.) to the commit message and

  lets you do that in your preferred editor.

* Unlike [gitmoji-cli] that downloads and caches its emoji database at runtime, `gimoji` uses a

  pre-compiled database that is included in the binary itself, hence it's much faster to start up

  and does not need Internet access.

The philosophy here is to enable you to quickly and easily choose an emoji and get out of your way.

## License

[MIT](LICENSE)

[gitmoji]: https://github.com/carloscuesta/gitmoji

[gitmoji-cli]: https://github.com/carloscuesta/gitmoji-cli

[slow]: https://github.com/carloscuesta/gitmoji-cli/issues/1096