Skip to content

bacongravy/emoji-favicon-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

emoji-favicon-cli

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.

Usage

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.

Examples

npx emoji-favicon-cli
npx emoji-favicon-cli tada
npx emoji-favicon-cli -d public ghost
npx emoji-favicon-cli -v apple sunglasses

How to use the favicon

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" />

Supported vendors

The following emoji vendors are supported:

  • apple
  • facebook
  • github
  • google
  • joy-pixels
  • samsung
  • twitter
  • webfx
  • windows

Image sources

This tool does not include any emoji images in its package. Emoji images are retrieved at runtime from the following sources:

GitHub project assets are retrieved via the JSDelivr content delivery network.

Known limitations

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.

About

A CLI tool to generate favicons from emoji names

Topics

Resources

License

Stars

Watchers

Forks