Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jsumners/alfred-emoji
Alfred workflow for searching and copying emoji
https://github.com/jsumners/alfred-emoji
Last synced: 3 days ago
JSON representation
Alfred workflow for searching and copying emoji
- Host: GitHub
- URL: https://github.com/jsumners/alfred-emoji
- Owner: jsumners
- Created: 2017-08-24T20:24:39.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-02-10T13:55:24.000Z (9 months ago)
- Last Synced: 2024-10-17T17:01:16.390Z (18 days ago)
- Language: JavaScript
- Size: 1.98 MB
- Stars: 743
- Watchers: 9
- Forks: 32
- Open Issues: 17
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
- alfred-workflows - Emoji Search - Search and copy emojis. (Utility)
README
# alfred-emoji
[](https://travis-ci.org/jsumners/alfred-emoji)
An [Alfred workflow][alfred] that makes it easy to search for emoji and copy
them to the clipboard 🤘.
> ## Note About Available Emoji
>
> The workflow is built against the latest available macOS within the GitHub
> continuous integration infrastructure. This means some emoji may be missing
> until the GitHub infrastructure is updated. It also means that some emoji
> may be present in the workflow that do not exist on your system if your
> system is running an earlier version of macOS.
>
> If this is not desired, follow the instructions below for generating the
> workflow on your own system.
## Installing the Workflow
[Download the provided Alfred workflow][releases].
Notice: This workflow relies on JXA (JavaScript for Automation) that is built
into macOS.
## Usage
```
emoji [query]
```
Press return (↵): **Copy the symbol** of the selected emoji (e.g. 🤣) to
your clipboard.
Press alt+return (⌥↵): **Copy the code** of the selected emoji)
(e.g. `:rofl:`) to your clipboard.
Press ctrl+return (⌃↵): **Copy the codepoint** **of** the selected emoji)
(e.g. `U+1F923`) to your clipboard.
Press shift+return (⇧↵): **Copy the default symbol** of the selected emoji)
(e.g. 🤣) to your clipboard without skin tone modifier.
Press cmd+return (⌘↵): **Paste the symbol** of the selected
emoji (e.g. 🤣) directly to your frontmost application.
### Set skin tone
To change the emoji skin tone for supported emoji set the `skin_tone` environment variable in Alfred:
Options:
- No value => 👍
- `0` => 👍🏻
- `1` => 👍🏼
- `2` => 👍🏽
- `3` => 👍🏾
- `4` => 👍🏿
- `random` => 👍🏻 | 👍🏼 | 👍🏽 | 👍🏾 | 👍🏿
After setting skin tone you can still quickly copy the default emoji with the shift modifier.
## Automatic Updates
This workflow will automatically check for updates at most once per day. If a
new release is found, it automatically downloads and installs the latest
version of the workflow. All downloads come directly from official [GitHub
releases][releases].
## Optional Hotkey and Snippet Triggers
Trigger the workflow with either a custom hotkey or a custom snippet.
## Building the Workflow
1. Clone this repository
2. `npm install`
3. `npm run build`
## Loading the Workflow into Alfred
1. `npm run load`
## Inspiration
This is based on the original work by [Carlos Galdino][carlos]. His project
seems to be unmaintained (some emoji don't copy and some newer are missing).
Whereas his project is based on the Ruby language, this one is based on
JavaScript.
## Other
* [Associated Alfred Forum Post][alfredforum]
* [Emoji Keyword Library][emojilib]
## License
[MIT License](http://jsumners.mit-license.org/)
[alfred]: https://alfredapp.com/
[carlos]: https://github.com/carlosgaldino/alfred-emoji-workflow/
[releases]: https://github.com/jsumners/alfred-emoji/releases
[alfredforum]: https://www.alfredforum.com/topic/11126-alfred-emoji-search-emojis-by-name-or-keyword/
[emojilib]: https://github.com/muan/emojilib