-
-
Notifications
You must be signed in to change notification settings - Fork 30
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Updated README - Minor fixes for packaging
- Loading branch information
1 parent
225d15d
commit c8da929
Showing
18 changed files
with
329 additions
and
90 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,52 +1,52 @@ | ||
# Emoji keyboard | ||
|
||
Virtual keyboard-like emoji picker for Linux. | ||
Virtual keyboard-like emoji palette for Linux. | ||
|
||
Emoji artwork and metadata provided by [Emoji Two](https://emojitwo.github.io/) | ||
by [Ranks.com](http://www.ranks.com/) and is licensed under | ||
[CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/legalcode). | ||
Emoji support on Linux is shaky at best. Modern distributions finally support | ||
displaying color emoji, but using emoji is inconsistent and inconvenient. | ||
|
||
Additional artwork provided by | ||
[Twitter Emoji](https://github.com/twitter/twemoji) | ||
([CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/legalcode)) and | ||
[Noto Emoji](https://github.com/googlei18n/noto-emoji) | ||
([Apache 2.0](https://github.com/googlei18n/noto-emoji/blob/master/LICENSE)). | ||
Enter `emoji-keyboard`! Press a hotkey (default `Ctrl+Super+Space`) or choose `Palette` | ||
from app indicator and an emoji palette opens. Then just click on emoji you want to use | ||
and watch them appear in the active application! | ||
|
||
## Installation | ||
> **Tip:** hold shift when using the terminal and you can type emoji into the terminal | ||
> **Tip:** you can choose to copy emoji into the clipboard instead in the `Preferences` | ||
Easy. | ||
|
||
You can install emoji keyboard from [pypi](https://pypi.org/project/emoji-keyboard). | ||
Not sure which emoji to use? Press `Ctrl+Super+F` or choose `Search` from app indicator | ||
and you can search emoji by name, short code or emoticon. | ||
|
||
First you need pip and pygobject bindings, on Debian based distros you can get them with: | ||
> **Tip:** don't want to use mouse after searching? Press up/down arrows and `Enter` to type | ||
```sudo apt install python3-pip python3-gi gir1.2-gtk-3.0 gir1.2-glib-2.0``` | ||
Got emoji you use frequently? Memorize short code (you can see it when hovering emoji | ||
in the palette) and then just type it and watch it be replaced by the emoji. | ||
|
||
Next run this command (on other distros it may just be `pip` depending on how you installed pip): | ||
> **Tip:** you can disable this feature in `Preferences`. It doesn't play well with Firefox | ||
```pip3 install --user https://github.com/OzymandiasTheGreat/emoji-keyboard/archive/master.zip``` | ||
And of course there's eye-candy. Choose emoji set you prefer or app and panel themes to match your system. | ||
|
||
Now start the indicator by running `emoji-keyboard` and start typing those emoji! | ||
## Credits and License | ||
|
||
## Usage | ||
`emoji-keyboard` is release under GPLv3 or later license. | ||
|
||
### Keyboard | ||
© 2020 [Ozymandias (Tomas Ravinskas)](mailto:[email protected]) | ||
|
||
Selecting `Show Keyboard` from the app indicator menu or, if your desktop | ||
environment supports it, middle-clicking app indicator will toggle the visibility | ||
of the keyboard. When the picker is visible simply clicking on emoji will type it | ||
into focused application. | ||
Emoji artwork and metadata provided by: | ||
|
||
### Search | ||
[Blobmoji](https://github.com/c1710/blobmoji) by Google Inc. and is licensed under [Apache-2.0](https://github.com/C1710/blobmoji/blob/master/LICENSE) | ||
|
||
You can search by official unicode name or by :shortname:. | ||
Pressing `enter` will select and type the first result. | ||
[Emoji Two](https://emojitwo.github.io/) by [Ranks.com](http://www.ranks.com/) and is licensed under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/legalcode). | ||
|
||
### Hotkeys | ||
[Noto emoji](https://github.com/googlefonts/noto-emoji) by Google Inc. and is licensed under [Apache-2.0](https://github.com/googlefonts/noto-emoji/blob/master/LICENSE) | ||
|
||
`emoji-keyboard` can be controlled from the command line. Use your desktop's | ||
native hotkey utility to assign hotkeys to | ||
[Twemoji](https://github.com/twitter/twemoji) by [Twitter](https://twemoji.twitter.com/) and is licensed under [CC-BY-4.0](https://github.com/twitter/twemoji/blob/master/LICENSE-GRAPHICS) | ||
|
||
`emoji-keyboard -k` to toggle visibility of the keyboard, | ||
[Openmoji](https://github.com/hfg-gmuend/openmoji) by [openmoji.org](https://openmoji.org/about/#team) and is licensed under [CC-BY-SA-4.0](https://creativecommons.org/licenses/by-sa/4.0/) | ||
|
||
## Installation | ||
|
||
`emoji-keyboard -s` to toggle visibility of the search window. | ||
Grab AppImage from [releases page](https://github.com/OzymandiasTheGreat/emoji-keyboard/releases) and just run it! | ||
|
||
Run `emoji-keyboard -h` in the terminal to get full list of commands. | ||
## Feedback is always WELCOME |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,8 +1,9 @@ | ||
{ | ||
"name": "emoji-keyboard", | ||
"version": "3.0.0", | ||
"description": "Virtual keyboard-like emoji palette", | ||
"version": "3.0.0rc0", | ||
"description": "Type emoji easily! Virtual keyboard-like emoji palette for Linux with lots of features.", | ||
"homepage": "https://github.com/OzymandiasTheGreat/emoji-keyboard", | ||
"repository": "https://github.com/OzymandiasTheGreat/emoji-keyboard", | ||
"author": { | ||
"name": "Ozymandias (Tomas Ravinskas)", | ||
"email": "[email protected]" | ||
|
@@ -90,7 +91,6 @@ | |
"@mdi/font": "4.9.95", | ||
"custom-electron-titlebar": "3.2.2-hotfix62", | ||
"ini": "1.3.5", | ||
"interactjs": "1.8.4", | ||
"object-observer": "2.5.2", | ||
"python-shell": "1.0.8", | ||
"spinkit": "2.0.1", | ||
|
Oops, something went wrong.