CTAN Comprehensive TeX Archive Network

Directory graphics/pgf/contrib/byo-twemojis


Build You Own Twemojis

This package allows you to create your own twemojis (the simple round, yellow ones). The package provides the command \byoTwemoji which creates a TikZ picture based on the elements (eyes, mouth, ...) given to the command.

This package is based on twemoji 13.0.1.



The emojis and all derived graphics belong to Twitter, Inc and other contributors (Copyright 2019). They are licensed under CC-BY 4.0: https://creativecommons.org/licenses/by/4.0/.

Hence, attribution of the original work is needed.


I'm no lawyer, so take this section with a grain of salt.

As the emojis themselves are licensed under CC-BY they require attribution but are open to be distributed and modified anyway you like (which makes these packages possible). I'm not sure whether the attribution in the package's source code and in this repository is enough for a file (e.g. PDF) generated with this package to be covered as well (doubt it, really).

So, I see two different possibilities to attribute the emojis in a compiled document:

  1. Add attribution to the metadata of the document. For example with https://www.ctan.org/pkg/hyperxmp in PDF files.
  2. Add attribution in the document directly (e.g. on the last page of a presentation). For example:
  3. Emoji graphics licensed under CC-BY 4.0: https://creativecommons.org/licenses/by/4.0/
    Copyright 2019 Twitter, Inc and other contributors
  4. I consider this option to be the safest.


The packages are licensed under the LPPL 1.3 or later License.

Copyright (c) 2021 Jost Rossel
This file may be distributed and/or modified under the
conditions of the Project Public License, either
version 1.3 of this license or (at your option) any later
version. The latest version of this license is in:




and version 1.3 or later is part of all distributions of
version 2005/12/01 or later.

Download the contents of this package in one zip archive (392.4k).

byo-twemojis – “Build Your Own Twemojis” with TikZ

This package provides the means to create your own emojis (the simple, round, and mostly yellow ones) from elements of existing emojis. The provided command creates a TikZ picture from the stated elements with multiple possibilities to modify the result in color and position.

Bug trackerhttps://gitlab.com/rossel.jost/latex-twemojis/-/issues
Version1.0 2021-04-19
LicensesCC BY 4.0
The Project Public License 1.3
Copyright2019 Twitter, Inc and other contributors
2021 Jost Rossel
MaintainerJost Rossel
Contained inTeX Live as byo-twemojis
MiKTeX as byo-twemojis
Guest Book Sitemap Contact Contact Author