2015-09-25 21:17:46 +00:00
![Noto ](images/noto.png )
# Noto Emoji
2015-08-17 21:53:17 +00:00
Color and Black-and-White Noto emoji fonts, and tools for working with them.
2020-04-14 14:56:16 +00:00
## Prerequisites
2020-04-14 15:34:35 +00:00
Building Noto Color Emoji requires:
- Python 3
- [pkg-config ](https://www.freedesktop.org/wiki/Software/pkg-config/ )
- [pngquant ](https://pngquant.org/ )
2020-05-30 21:19:49 +00:00
- [zopflipng ](https://github.com/google/zopfli )
2020-08-27 21:33:19 +00:00
- [cairo ](https://www.cairographics.org/ )
2020-10-27 10:44:17 +00:00
- [imagemagick ](https://imagemagick.org/ )
2020-04-14 14:56:16 +00:00
2015-12-08 22:53:22 +00:00
## Building NotoColorEmoji
2020-05-30 21:19:49 +00:00
This project uses a virtual environment to manage dependencies. Use the following steps to get up and running:
2015-12-08 22:53:22 +00:00
2020-05-30 21:19:49 +00:00
```shell
# make sure you have the Prerequisites
2020-04-10 14:21:37 +00:00
2020-05-30 21:19:49 +00:00
# create & activate a virtual environment
python3 -m venv venv
source venv/bin/activate
2020-04-10 14:21:37 +00:00
2020-05-30 21:19:49 +00:00
# install python requirements
pip install -r requirements.txt
2020-04-10 14:21:37 +00:00
2020-05-30 21:19:49 +00:00
time make -j
```
2020-04-10 14:21:37 +00:00
2020-12-14 10:15:54 +00:00
Intermediate products (compressed image files, for example) will be put into a build subdirectory. Two fonts will be saved at the top level:
* `NotoColorEmoji.ttf` , for general use.
* `NotoColorEmoji_WindowsCompatible.ttf` , specifically meant to be _installed_ on Windows.
2015-12-08 22:53:22 +00:00
2017-03-16 22:19:44 +00:00
## Using NotoColorEmoji
NotoColorEmoji uses the CBDT/CBLC color font format, which is supported by Android
2019-06-18 07:36:54 +00:00
and Chrome/Chromium OS. Windows supports it starting with Windows 10 Anniversary
2020-05-26 17:20:08 +00:00
Update in Chrome and Edge. On macOS, only Chrome supports it, while on Linux it will
2019-06-18 07:36:54 +00:00
support it with some fontconfig tweaking, see [issue #36 ](https://github.com/googlei18n/noto-emoji/issues/36 ). Currently we do not build other color font formats.
2017-03-16 22:19:44 +00:00
2017-09-20 17:05:31 +00:00
## Color emoji assets
The assets provided in the repo are all those used to build the NotoColorEmoji
font. Note however that NotoColorEmoji often uses the same assets to represent
different character sequences-- notably, most gender-neutral characters or
sequences are represented using assets named after one of the gendered
sequences. This means that some sequences appear to be missing. Definitions of
2017-09-20 18:31:17 +00:00
the aliasing used appear in the emoji_aliases.txt file.
2017-09-20 17:05:31 +00:00
Also note that the images in the font might differ from the original assets. In
particular the flag images in the font are PNG images to which transforms have
been applied to standardize the size and generate the wave and border shadow. We
do not have SVG versions that reflect these transforms.
## B/W emoji font
The black-and-white emoji font is not under active development. Its repertoire of
emoji is now several years old, and the design does not reflect the current color
emoji design. Currently we have no plans to update this font.
2015-09-25 21:17:46 +00:00
## License
Emoji fonts (under the fonts subdirectory) are under the
[SIL Open Font License, version 1.1 ](fonts/LICENSE ).< br />
2016-10-20 17:47:11 +00:00
Tools and most image resources are under the [Apache license, version 2.0 ](./LICENSE ).
Flag images under third_party/region-flags are in the public domain or
otherwise exempt from copyright ([more info](third_party/region-flags/LICENSE)).
2015-09-25 21:17:46 +00:00
## Contributing
2015-08-17 21:53:17 +00:00
Please read [CONTRIBUTING ](CONTRIBUTING.md ) if you are thinking of contributing to this project.
2015-09-25 21:17:46 +00:00
## News
2017-09-20 17:05:31 +00:00
* 2017-09-13: Emoji redesign released.
2015-12-08 22:53:22 +00:00
* 2015-12-09: Unicode 7 and 8 emoji image data (.png format) added.
2015-09-25 21:17:46 +00:00
* 2015-09-29: All Noto fonts now licensed under the SIL Open Font License.