README.md (1926B)
1 # dmenu-emoji 💃 2 3 Search an emoji by name and copy it to the clipboard. Works best with a dmenu variant that does fuzzy search such as [rofi](https://github.com/DaveDavenport/rofi), but it's compatible with plain [dmenu](https://tools.suckless.org/dmenu/). 4 5 If possible, it also sends a desktop notification for better user feedback. 6 7 [](https://i.imgur.com/E6kJHGL.gifv) 8 9 [Click the screenshot for a 4MB GIF of how the emoji in the header was added] 10 11 ## Usage with i3 12 13 Download `dmenu-emoji.sh`, make sure it's executable (`chmod + x <file>`), and store it somewhere in your home directory (or in your `$PATH` if you prefer). Assign a keystroke in your [i3](https://i3wm.org/) configuration: 14 15 ``` 16 # ~/.config/i3/config 17 18 bindsym $mod+space exec path/to/dmenu-emoji.sh 19 ``` 20 21 `dmenu-emoji.sh` is the only file you need, the rest of the files in this repository are scripts to generate that one, which you don't need unless you want to modify it (PRs welcome!). 22 23 ### Tweeking the `dmenu` command 24 25 By default, `dmenu` is called. If you want to use a different menu or pass some option to it, you can use the `list` and `copy` subcommands: 26 27 ``` 28 # ~/.config/i3/config 29 30 bindsym $mod+space exec dmenu-emoji.sh list | rofi -dmenu -p 'Emoji: ' | dmenu-emoji.sh copy 31 ``` 32 33 ## Similar scripts 34 35 * [emoji.sh](https://gist.github.com/markmandel/546fc099590f1c08fa936795ac9da143). One liner, requests emojis each time, no autocomplete 36 * [rofimoji](https://github.com/fdw/rofimoji). Python-based, rofi only, can insert directly instead of copy&paste 37 * [emoji-rofi-menu](https://github.com/rob-a-bolton/emoji-rofi-menu). Rofi only, can insert directly 38 * [rofi-emoji](https://github.com/hatzel/rofi-emoji/). Python-based (but generates a bash script so Python is not used each time), rofi only, inserts-directly 39 40 It takes very little time to write so there are probably more 😅