This repo currently contains color emoji fonts generated from the Openmoji, Twemoji, and EmojiTwo sets of emoji graphics.

These fonts are in the COLR/CPAL font format (specifically v0 of the format, which doesn't support gradients). COLRv0 fonts are significantly smaller than SVGinOT format color fonts, and are supported by practically all modern browsers.

To preview the fonts in use, take a look at the table on this page.

Take a look in the 'fonts' folder of this repo, or at the releases.

These files can be downloaded and installed, or they can be hosted on a web server and loaded via css. No special frameworks required.

On MacOS or Linux:

1. Clone this repo.

2. Navigate to the repo's folder in a command line.

3. Create a python virtual environment with python3 -m venv colrvenv, where 'colrvenv' can be substituted for whatever you want the path to the virtual environment to be.

4. Activate the virtual environment with source colrvenv/bin/activate

5. Install my fork of Google's nanoemoji tool into the virtual environment with
   pip install git+https://github.com/Emoji-COLRv0/nanoemoji.git

6. Unzip the .zip file cooresponding to the font you want to build. Navigate into that folder. When you run ls, you should see a folder called "svg" and a file called "config.toml".

7. Run nanoemoji with nanoemoji --config 'config.toml' $(find svg -name '*.svg')

The script should then start running. It will take a while to complete. If successful, a build folder will be created, and the font file will be inside it.

Further information can be found in the README within each folder.

The svg files within src-emojitwo come from the EmojiTwo project.

Emoji artwork is provided by Emojitwo, originally released as Emojione 2.2 by Ranks.com Joypixels with contributions from the Emojitwo community and is licensed under CC-BY 4.0.

The font file named 'EmojiTwoCOLRv0.ttf' is built using these graphics. Please credit both Joypixels and the EmojiTwo community if you use this font elsewhere.

The svg files within src-twemoji come from the Twitter Emoji project, and are licensed under CC-BY-4.0.

The font file named 'TwemojiCOLRv0.ttf' is built using these graphics. Please credit the Twemoji project if you use this font elsewhere.

The svg files within src-openmoji come from the OpenMoji project, and are licensed under the Creative Commons Share Alike License 4.0 (CC BY-SA 4.0). This means that the graphics can be freely used as long as proper attribution is given and any derivative works are released under the same license.

Here is the attribution suggestion from the project's README

All emojis designed by OpenMoji – the open-source emoji and icon project. License: CC BY-SA 4.0

The font file named 'OpenMojiCOLRv0.ttf' is built using these graphics. Please credit the OpenMoji project if you use this font elsewhere.