openmoji-named-svgs

⚠️ Unofficial redistribution. This package is not affiliated with, endorsed by, or maintained by the OpenMoji project or HfG Schwäbisch Gmünd. It is a community redistribution of the official OpenMoji SVG assets with filenames changed from Unicode hexcodes (e.g. 1F600.svg) to human-readable slugs (e.g. grinning-face.svg). For the official project, use the openmoji npm package.

All emoji artwork and metadata are the work of the OpenMoji team and contributors. Only the filenames and packaging differ in this distribution.

What's inside

openmoji-named-svgs/
├── color/     # 4,495 full-color SVGs
├── black/     # 4,495 monochrome (black) SVGs
├── package.json
├── README.md
├── LICENSE.txt   # CC-BY-SA-4.0 (same as upstream OpenMoji)
└── NOTICE.md     # attribution and list of changes

Each folder contains one SVG per OpenMoji glyph, named by its annotation field from data/openmoji.json in the upstream project.

Naming rules

Source annotation → filename transform:

1. Unicode normalize (NFKD) and strip diacritics: café → cafe.
2. Lowercase.
3. Replace any run of non-[a-z0-9] characters with a single -.
4. Trim leading/trailing -.
5. On duplicate annotations (13 cases like donkey, axe, pretzel), append -2, -3, …, ordered by ascending Unicode hexcode so the lowest-codepoint entry gets the plain name.

Examples:

| Upstream file | This package | |---|---| | 1F600.svg | grinning-face.svg | | 1F44B-1F3FE.svg | waving-hand-medium-dark-skin-tone.svg | | 1F9B9-1F3FE-200D-2640-FE0F.svg | woman-supervillain-medium-dark-skin-tone.svg | | E001.svg (donkey) | donkey-2.svg (emoji 1F434 holds donkey) |

Usage

// e.g. in a bundler with a static-import plugin
import grinningFace from 'openmoji-named-svgs/color/grinning-face.svg';

Or serve the folder directly from a CDN / static host.

License

Artwork and data: CC BY-SA 4.0 — same as upstream OpenMoji. See LICENSE.txt.

Under CC BY-SA 4.0 you must:

• Attribute the OpenMoji project ("OpenMoji – the open-source emoji and icon project. License: CC BY-SA 4.0") with a link to the license.
• ShareAlike — redistribute any modifications under the same license.
• Indicate changes — see NOTICE.md for the changes made in this redistribution.

Credits

All emoji artwork © OpenMoji contributors — https://openmoji.org/ — licensed under CC BY-SA 4.0. Upstream repository: https://github.com/hfg-gmuend/openmoji