Browse Source

Readme clarification.

master
Mathieu Laparie 1 year ago
parent
commit
7fab5527b8
1 changed files with 7 additions and 5 deletions
  1. 7
    5
      README.md

+ 7
- 5
README.md View File

@@ -19,7 +19,7 @@ The list of unicode characters was originally created by [/u/fe80c0ffee](https:/

* An emoji capable font, for example [Noto Emoji](https://www.google.com/get/noto/#emoji-zsye) or [Noto Color Emoji](https://www.google.com/get/noto/#emoji-zsye-color).
* `xsel` to copy the selection to the clipboard. You should find it in your package manager.
* `rofi`, from [davatorium/rofi](https://github.com/davatorium/rofi) but probably available in your package manager as well.
* `rofi` from [davatorium/rofi](https://github.com/davatorium/rofi) but probably available in your package manager as well.

## Usage example
Add a custom keybinding using your window-manager settings for the following command:
@@ -30,7 +30,7 @@ rofi -show windowcd -theme-str '#window{width: 30%;}' # See the rofi documentati
Invoke rofi using your keybinding, navigate through tabs using `Ctrl+Tab` (default) and search emojis or unicode characters by keyword. Pressing `Return` will copy the highlighted character to the clipboard and close rofi.

## Recommended configuration
For rofi to look like the above screenshots, use the supplied `config` file and `sidetab-adapta.rasi` theme (originally taken from the [davatorium/rofi-themes](https://raw.githubusercontent.com/davatorium/rofi-themes/master/User%20Themes/sidetab-adapta.rasi) collection):
For rofi to look like the above screenshots, use the supplied `config` file and `sidetab-adapta.rasi` theme (originally taken from the [davatorium/rofi-themes](https://raw.githubusercontent.com/davatorium/rofi-themes/master/User%20Themes/sidetab-adapta.rasi) collection). This can be done simply by running the following commands:

```bash
mv $HOME/.config/rofi/config $HOME/.config/rofi/config.back
@@ -38,10 +38,12 @@ cp $HOME/.config/rofiemoji-rofiunicode/config.example $HOME/.config/rofi/config
mkdir -p $HOME/.local/share/rofi/themes
cp $HOME/.config/rofiemoji-rofiunicode/sidetab-adapta.rasi $HOME/.local/share/rofi/themes/
```
It is assumed that `rofi/` and `rofiemoji-rofiunicode/` directories are both located in `~/.config/`. The `config` file supplied here is customized to my own preferences and to the characteristics of my system. Make sure you reviewed the few uncommented lines to check whether my custom changes will work on your system. For instance, this `config` file is set to make rofi work with gnome-terminal, but default rofi values might work best with other terminals.
It is assumed, however, that `rofi/` and `rofiemoji-rofiunicode/` directories are both located in `~/.config/`.

The `config` file supplied here is customized to my own preferences and to the characteristics of my system. Make sure you reviewed the few uncommented lines to check whether my changes will work on your system. For instance, this `config` file makes rofi work with gnome-terminal, but default rofi values might work best with other terminals.

## Alternative

An alternative based on [rofimoji by fdw](https://github.com/fdw/rofimoji) instead of rofi-scripts, but still with the addition of unicode characters from [/u/fe80c0ffee](https://www.reddit.com/r/unixporn/comments/7zqkov/oc_i_mad_a_rofi_emoji_picker_and_i_feel_bad_about/duqls53?utm_source=share&utm_medium=web2x), is [Kabouik/rofimoji](https://github.com/Kabouik/rofimoji). It allows multiple selection of emojis or unicode characters, as well as direct input without the clipboard step, but the window customisation is not as flexible.
An alternative based on the original [rofimoji by fdw](https://github.com/fdw/rofimoji) instead of the [nkoehring/rofiemoji](https://github.com/nkoehring/rofiemoji) script version, but still with the addition of unicode characters from [/u/fe80c0ffee](https://www.reddit.com/r/unixporn/comments/7zqkov/oc_i_mad_a_rofi_emoji_picker_and_i_feel_bad_about/duqls53?utm_source=share&utm_medium=web2x), is [Kabouik/rofimoji](https://github.com/Kabouik/rofimoji). It allows multiple selection of emojis or unicode characters, as well as direct input without a clipboard step, but the customization possibilities are more limited and there is no visual unification with your main rofi instance.

![Kabouik/rofimoji](https://reho.st/medium/https://github.com/Kabouik/rofimoji/raw/master/screenshot-fork.png?raw=true)
![Kabouik/rofimoji](https://github.com/Kabouik/rofimoji/raw/master/screenshot-fork.png?raw=true)

Loading…
Cancel
Save