alex1701c / EmojiRunner

Search for emojis in Krunner and copy/paste them
GNU General Public License v3.0
50 stars 7 forks source link
c-plus-plus emoji emoji-picker kde krunner plasma5 qt5

Emoji Runner

You can build this package from source or use the deb/rpm packages from the releases page.

Required Dependencies

Note: If the xdo.h file is not at compile time available the plugin will use the xdotool program to paste emojis, but having the library installed is recommended.

Debian/Ubuntu Plasma5: ```bash install-ubuntu-plasma5 sudo apt install git cmake extra-cmake-modules build-essential gettext libkf5runner-dev qtdeclarative5-dev gettext libxdo-dev libkf5kcmutils-dev libkf5dbusaddons-bin ``` Plasma6: ```bash install-ubuntu-plasma6 sudo apt install git cmake extra-cmake-modules build-essential gettext libkf6runner-dev libxdo-dev libkf6kcmutils-dev libkf6dbusaddons-bin ```
OpenSUSE Plasma5: ```bash install-opensuse-plasma5 sudo zypper install git cmake extra-cmake-modules ki18n-devel krunner-devel kconfigwidgets-devel kcmutils-devel gettext-tools xdotool-devel kdbusaddons-tools ``` Plasma6: ```bash install-opensuse-plasma6 sudo zypper install git cmake kf6-extra-cmake-modules kf6-ki18n-devel kf6-krunner-devel gettext-tools xdotool-devel kf6-kconfigwidgets-devel kf6-kcmutils-devel kf6-kdbusaddons-tools ```
Fedora Plasma5: ```bash install-fedora-plasma5 sudo dnf install git cmake extra-cmake-modules gettext kf5-ki18n-devel kf5-krunner-devel kf5-kcmutils-devel libxdo-devel ``` Plasma6: ```bash install-fedora-plasma6 sudo dnf install git cmake gettext extra-cmake-modules kf6-ki18n-devel kf6-krunner-devel kf6-kcmutils-devel libxdo-devel ```
Arch (Manjaro) ```bash sudo pacman -S cmake extra-cmake-modules xdotool kcmutils ``` *This xdotool package includes the xdo.h file*

Build instructions

Option A: Easy oneliner method

curl https://raw.githubusercontent.com/alex1701c/EmojiRunner/master/install.sh | bash

Option B: Get it from the AUR

Option C: Manual installation method

git clone https://github.com/alex1701c/EmojiRunner
cd EmojiRunner
bash install.sh

Info: The emoji.json file is a modified version from gemoji.

Enable Shortcuts

This project has a EmojiRunnerCommands.khotkeys file. This file contains two shortcuts (of course you can change them):

These shortcuts start Krunner using qdbus. For example the command to launch the favourites is:
qdbus org.kde.krunner /App org.kde.krunner.App.querySingleRunner "emojirunner" "emoji "

You can import them in the System Settings module "Custom Shortcuts" by clicking on edit and then import.

The feature to paste the emojis can be disabled in the config dialog.

Search for emoji and paste

Screenshots:

Search for an emoji by name

This global search can be enabled/disabled in the config dialog.
Additionally this screenshot shows the paste action, which is a new feature.
Search for an emoji by name

Show favourites

They are configured in the config dialog
Show favourites

Search for emojis

This way you can search for emojis without search results from other plugins
Search for emojis

Configure settings

You can search for emojis, set the unicode level (later versions can not be displayed) and you can enable/disable categories. Additionally you can sort the favourites using drag and drop
Search for emojis

Add a custom emoji

You must provide a name and and emoji, the description and tags are optional
Add a custom emoji

This gets saved in the ~/.local/share/emojirunner/customemojis.json file.
Custom emojis file

Issues

If you have any other issues please let me know 😄.