Skip to content

๐Ÿ˜„ Emoji copy is a versatile extension designed to simplify emoji selection and clipboard management.

License

Notifications You must be signed in to change notification settings

FelipeFTN/Emoji-Copy

Repository files navigation

Emoji Copy ๐Ÿ˜Ž

This GNOME shell extension provides a emoji search pop-up menu. ๐Ÿš€
Want any emoji? It's right into your top bar!
This repo is a Fork from emoji-selector-for-gnome and was created for keeping the extension alive. Please feel free to use and contribute to this project. ๐Ÿ˜ƒ

Features ๐Ÿš€

  • keyboard shortcut to open the extension's menu (Super+. by default)
  • dynamic search (press Enter to copy the first result to the clipboard)
  • lots of configurable things
  • skin tone & gender modifiers
  • middle-click to set to the clipboard without closing the menu (or Ctrl+Enter)
  • right-click to add the emoji at the end of the current clipboard content (or Shift+Enter)

Keyboard navigation is designed to work with Tab, not the arrows.

Installation ๐Ÿ€

Recommended

The easiest way to install it is directly from Gnome Extensions: emoji-copy

Native packages

Work in progress...

We need to publish this project to most known package managers, like AUR, Fedora and so on.

Manual installation

Not recommended at all: installing the extension this way will prevent any further updates.

  1. Download and extract the ZIP, then open a terminal in the project's directory.
  2. Choose a way to install the extension:
    --> Make ๐Ÿ”ฅ
    $ make install

    --> NPM ๐Ÿ˜‡
    $ npm run deploy

    --> Shell scripts ๐Ÿคจ
    $ sh install.sh

    --> Hardcore ๐Ÿ’€
    $ cp -a ./emoji-copy@felipeftn $HOME/.local/share/gnome-shell/extensions

You may need to restart the GNOME Shell environment (Alt+F2 -> restart -> Enter).
(X11 only, if you are in Wayland, sign out and sign in from the session manually).

Debug and Test ๐Ÿ—

We have a lot of ways to debug and test our code. Currently, we already have a complete guide to debug and test our extension in a local environment described in debug.md file.
In a simpler way, you can debug the code in two ways:

    --> Make ๐Ÿ”ฅ
    $ make debug

    --> Gnome Dbus Session ๐Ÿšง
    $ make && dbus-run-session -- gnome-shell --nested --wayland

Memory performance ๐Ÿ‘พ

Loading hundreds of small pictures and thousands of keywords into the memory is a lot. Despite a few attempts to optimize their loading, I'm not an expert at all concerning memory management, and the extension may be responsible for between 10MB and 60MB of memory usage, which is a lot. Don't blame the actual GS devs for it.

โœจ Update:
Currently, we are loading emojis with SQLite. With a SQL query system, we were able to load just the necessary amount of emojis for each category. All the emojis are "pre-compiled" during the building process, and generates a emojis.db file at data directory (inside extension's directory).
We still can do a lot of improvements in the way we load and display these emojis. Maybe some skeletons and non-syncronous loading should be great to avoid slow loadings.

Fonts ๐Ÿ” 

It will be less ugly if you have the ยซ Noto Emoji ยป font, the ยซ Twitter Color Emoji ยป font, or the ยซ JoyPixels Color ยป font installed on your system.

Contributors & translations ๐Ÿซ‚

Various contributions to the code itself:

The extension is currently available in the following languages:

  • ๐Ÿ‡ช๐Ÿ‡ธ Castillan (Thanks to @mario-mra)
  • ๐Ÿ‡จ๐Ÿ‡ณ Simplified chinese (Thanks to @larryw3i)
  • ๐Ÿ‡ณ๐Ÿ‡ฑ Dutch (Thanks to @vistaus)
  • ๐Ÿ‡บ๐Ÿ‡ณ Esperanto (Thanks to @nicolasmaia)
  • ๐Ÿ‡ฉ๐Ÿ‡ช German (Thanks to @jonnius)
  • ๐Ÿ‡ฎ๐Ÿ‡น Italian (Thanks to @amivaleo)
  • ๐Ÿ‡ต๐Ÿ‡ฑ Polish (Thanks to @alex4401)
  • ๐Ÿ‡ง๐Ÿ‡ท Brazilian/๐Ÿ‡ต๐Ÿ‡น Portuguese (Thanks to @nicolasmaia, @picsi & @frnogueira)
  • ๐Ÿ‡น๐Ÿ‡ท Turkish (Thanks to @mimoguz)
  • ๐Ÿ‡ท๐Ÿ‡บ Russian (Thanks to @jasursadikov)

If you need another language, please contribute! โค๏ธ