/slackmoji

A collection of 1,000+ emoji for Slack

Primary LanguageJavaScript

Table of Contents

Sets

See below for previews from each individual set:

Blob

blob-dancer-gif blob-love-gif blob-frog blob-dundundun-gif blob-wave-gif

Blob-Sign

blob-sign-omg blob-sign-ty blob-sign-gg blob-sign-thx blob-sign-brb

Froge

froge-angry2 froge-happy2 froge-dealwithit froge-suspicious froge-wink

Froggie

froggie-angry froggie-heart froggie-shocked froggie-squish-i froggie-vibing-gif

He Brings You

he-brings-you-a-knife-and-his-intentions-are-unclear he-brings-you-electricity.png he-brings-you-intensify he-brings-you-speed he-brings-you-zoom

Gopha

gopha-ok gopha-hide gopha-good-morning gopha-work gopha-sleepy

Llama

llama-awesome-gif llama-blush-gif llama-crying-gif llama-hi-gif llama-come-here-gif

Meow

meow-queen meow-cosmic meow-bread meow-im-fine meow-love

Parrots

parrot-github parrot-merged party-doge party-keanu parrot-nyan

Party

party-frog party-sunglasses party-tada party-100 party-peach

Pokemon

pkmn-pikachu pkmn-bulbasaur pkmn-squirtle pkmn-charmander pkmn-mew

Scrabble

l-e l-m l-o l-j l-i

Shiblob

shiblob-peek shiblob-photo shiblob-reach shiblob-nerd shiblob-wink

Uploading Emoji to Slack

  1. Clone or download this repository to your local machine. If you have downloaded the .zip file, unzip it using a third-party or built-in tool made for extracting archives.

  2. Follow one of the options below to begin uploading emoji:

    Option 1: Chrome extension

    1. Open Chrome and browse to:

      chrome://extensions

    2. Click on the Load unpacked button and select the extension folder from within this repository

    3. Navigate to $slackWorkspaceURL/customize/emoji, where $slackWorkspaceURL is the URL of the Slack workspace

      Note: 20 emoji will be uploaded per minute - be patient!

      Note: This extension has been adapted from the Neutral Face Emoji Tool and now lives here!

    Option 2: CLI

    1. Install slack-emoji-upload

    2. Get an xoxs-* Slack token following these instructions. (The team/email/password approach doesn't work, but token should)

    3. Stick the token in a variable, to keep it out of your shell history:

      read -s TOKEN $GENERATED_SLACK_TOKEN

    4. Change to the directory you want to import emoji from

    5. Run the following command, ensuring to substitute the name of your Slack workspace. The xargs prevents an open-files bug with an upload speed of one emoji every 4 seconds, or 15 per minute (20 max as per Slack rate limits):

      ls -1 | xargs -n 20 slack-emoji-upload -team $YOUR_SLACK_TEAM -token $GENERATED_SLACK_TOKEN -rate-limit 4s

Contributing New Emoji/Emoji Sets

Contributions are always welcome! In your pull request, please make sure to do the following:

  1. Create a new folder with a name that reflects the theme of the emoji you are adding, or use an existing one if applicable
  2. Ensure each emoji is under 100 KB in size and of a .png, .jpg, or .gif extension
  3. Ensure that each emoji is prefixed with the theme plus a hyphen, ie. gopha-xxx - this will allow users in Slack to easily search for gopha- and view all emoji for that set
  4. Run node generate-readme.js to generate/update README's for all of the newly added emoji!

Getting Help

If you ever have questions or need assistance, please open a GitHub issue best describing the problem!

Common Errors

  • Gifs over 100 KB will result in an upload error - use Ezgif.com to resize images under 100 KB
  • Emoji which conflict with reserved emoji names will result in a error_bad_name_i18n error

Credits

All emoji were sourced from the following repositories/websites: