OpenMoji
Open-source emojis for designers, developers and everyone else! OpenMoji is an open-source project of the HfG Schwäbisch Gmünd by Benedikt Groß, Daniel Utz, 70+ students and external contributors.
Interact, create, save, and share your work! #openmoji
This GitHub repository contains all of the source files and exported png/svg files of the OpenMoji project.
Table of Contents
- Styleguide Our beloved styleguide.
- FAQ Check if your question has already been answered
- Contributing Pull Requests are welcome!
- Developer Setup How to setup a environment.
- API documentation for the npm OpenMoji package.
- Font infos on the OpenMoji-Color and OpenMoji-Black fonts.
- Team list of all authors and contributors.
- Acknowledgements Thanks!
- Code of Conduct and OpenMoji Community Statement.
Downloads & Distribution Channels
You can download, use and "consume" OpenMoji in various ways:
- SVG: Color & Black (production ready)
- Fonts: Color & Black (experimental)
- PNG 618x618: Color & Black (production ready)
- PNG 72x72: Color & Black (production ready)
- OpenMoji app: for iOS with emoji picker
- OpenMoji Stickers: for iOS Messages app
- OpenMoji Github:
git clone --depth 1 https://github.com/hfg-gmuend/openmoji.git
The OpenMoji repo is big! It is recommended to clone it without the entire history, note the --depth flag. - OpenMoji NPM Package:
npm install openmoji
. You can also get individual files via UNPKG directly e.g.: unpkg.com/[email protected]/color/svg/1F64B.svg - CDN (will always fetch latest version - to pin to a version, see documentation here): cdn.jsdelivr.net/gh/hfg-gmuend/openmoji/color/svg/1F63A.svg
Community Extensions
- OpenMoji Jekyll Plugin:
gem install jekyll-openmoji
- OpenMoji Spritemap Generator: OpenMoji combined to handy sprite images
- OpenMoji in Fedora: For Fedora 33 and newer,
sudo yum install hfg-gmuend-openmoji-fonts-all
- OpenMoji in JavaFX: A cross-platform JavaFX library allowing you to replace all standard emoji in extended TextFlow (EmojiTextFlow) with OpenMoji.
- OpenMoji Awesome CSS Classes: "Font Awesome" flavored CSS classes eg.
<i class="oma oma-face-with-monocle"></i>
ready to use for websites. - OpenMoji Sticker Sets: Stickers for Telegram and WhatsApp.
- OpenMoji Flutter: OpenMoji usable as Icon for the FLutter framework.
Attribution Requirements
As an open source project, attribution is critical from a legal, practical and motivational perspective. Please give us credits! Common places for attribution are for example: to mention us in your project README, the 'About' section or the footer on a website/in mobile apps.
Attribution suggestion:
All emojis designed by OpenMoji – the open-source emoji and icon project. License: CC BY-SA 4.0
Anatomy of the OpenMoji Repository
black/
and color/
Contains all exported .png and .svg files ¹
data/
Contains the central openmoji.json with all meta informations for each emoji ¹
font/
Contains the exported OpenMoji fonts ¹
guidelines/
Contains various template files related to the styleguide ¹
helpers/
Contains various helper scripts e.g. to export to .png and .svg, generate skintones variants, enforce the OpenMoji color palette etc. ²
src/
Contains all source .svg files of OpenMoji. The files are broken up into folders and files corresponding with the Unicode groups and sub-groups ¹
test/
Automated unit tests to ensure consistency across all source .svg files ²
License
¹ OpenMoji graphics are licensed under the Creative Commons Share Alike License 4.0 (CC BY-SA 4.0)
² Code licensed under the GNU Lesser General Public License v3 (LGPL-3.0)