A CLI tool to generate a favicon.ico
file from an emoji name. Perfect for when you are spinning up a new project and need a favicon to get started.
Node.js version 8.2.0 or later is required. Use npx
to invoke the command:
npx emoji-favicon-cli [<emoji-name>] [-d <destination>] [-v <vendor>]
The command has the following basic behavior:
- Presents an interactive emoji browser in the terminal if the emoji name is not provided.
- Creates a file named
favicon.ico
at the destination. - Uses
.
as the default destination. - Uses
google
as the default vendor. For the full list of supported vendors, see below.
npx emoji-favicon-cli
npx emoji-favicon-cli tada
npx emoji-favicon-cli -d public ghost
npx emoji-favicon-cli -v apple sunglasses
Make sure the favicon.ico
file is in the root of the site's static files directory. Then put the following in the <head>
element of the site's index.html
:
<link rel="shortcut icon" href="/favicon.ico" />
The following emoji vendors are supported:
apple
facebook
github
google
joy-pixels
samsung
twitter
webfx
windows
This tool does not include any emoji images in its package. Emoji images are retrieved at runtime from the following sources:
- the
emojiii
project (cheatsheet) - the GitHub
emojis
API (cheatsheet) - the WebFX
emoji-cheat-sheet.com
project (cheatsheet)
GitHub project assets are retrieved via the JSDelivr content delivery network.
Emoji searching is powered by emojilib
. Not every vendor provides every emoji found in emojilib
, and some vendors provide additional emojis not found in emojilib
.