https://github.com/NoraCodes/charpicker

A fast, simple Emoji and special character picker for X and Wayland
https://github.com/NoraCodes/charpicker

emoji unicode unix wayland x

Last synced: 3 months ago
JSON representation

A fast, simple Emoji and special character picker for X and Wayland

• Host: GitHub
• URL: https://github.com/NoraCodes/charpicker
• Owner: NoraCodes
• Created: 2019-04-13T02:02:45.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-04-18T19:00:16.000Z (over 5 years ago)
• Last Synced: 2024-05-15T13:40:22.736Z (6 months ago)
• Topics: emoji, unicode, unix, wayland, x
• Language: Shell
• Size: 110 KB
• Stars: 70
• Watchers: 4
• Forks: 3
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Rofi Charpicker

A simple, fast, and keyboard-centric way to pick emoji, kaomoji, and special characters

under X and Wayland.

![A sample of Rofi Charpicker displaying a search for cakes](screenshots/charpicker%20sample.png)

## Installing Charpicker

You need to have `rofi` and `xdotool`. `rofi` handles selection and `xdotool` actually

enters the characters.

Then simply clone or download the repository and point a keyboard shortcut (I use Super+I)

at the script (`charpicker.sh`). If you only need a script to print the

selected character to the standard output, use `charpickerprint.sh`.

## Using Charpicker

You simply type a search into the Rofi search bar. Some conveniences are provided such

as `gi` for ι and `gI` for Ι (and similar for other Greek letters).

You can add modifiers like gender and skin tone with provided sequences. For instance,

"child" gives 🧒, while "child" "+ female" gives 🧒‍♀️ and "child" "+ medium-light

skin tone" gives 🧒‍🏼.

## Customizing Charpicker

Rofi Charpicker uses a simple flat file to store characters. The format of each line is:

```text

keywordscharacter

```

where `` is the actual tab character.

Everything after the tab character is typed, except trailing spaces (allowing kaomoji).

The project's provided file is `special_character_list`. It was compiled

partially with a machine and partially by hand (with help from mbfraga)

and contributions are much appreciated.

You can also have your own special character list:

`~/.config/charpicker/special_character_list`. The symbols in this file

are added to the provided symbols.

You can override the provided theme with the

`~/.config/charpicker/theme.rasi` file.