- HTML 97.6%
- JavaScript 2.1%
- Shell 0.3%
OpenMoji
openmoji-github-keyvisualOpen-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.
⚠️ Please note that the master branch is in active development, so if you're looking for stable production version please use one of the releases.
🛠 You can check the latest work in progress developments via the OpenMoji Dev Catalog which lists all OpenMojis of the master branch.
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.gitThe 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/openmoji@12.1.0/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 1
data/ Contains the central openmoji.json with all meta informations for each emoji 1
font/ Contains the exported OpenMoji fonts 1
guidelines/ Contains various template files related to the styleguide 1
helpers/ Contains various helper scripts e.g. to export to .png and .svg, generate skintones variants, enforce the OpenMoji color palette etc. 2
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 1
test/ Automated unit tests to ensure consistency across all source .svg files 2
License
1 OpenMoji graphics are licensed under the Creative Commons Share Alike License 4.0 (CC BY-SA 4.0)
2 Code licensed under the GNU Lesser General Public License v3 (LGPL-3.0)