Tired of managing dozens of favicons to support all the browsers, resolutions, and formats?
favicon_factory generates from an SVG the minimal set of icons needed by modern browsers.
The source SVG is ideal for modern browsers. And it may contain a <style> tag with @media (prefers-color-scheme: dark) to support light/dark themes, which is ignored when generating favicons.
Icons will be generated in the same folder as the source SVG unless already existing:
favicon.ico(32x32) for legacy browsers; serve it from/favicon.icobecause tools, like RSS readers, just look there.apple-touch-icon.png(180x180) for Apple devices when adding a webpage to the home screen; a background and a padding around the icon is applied to make it look pretty.manifest.webmanifestthat includesicon-192.png,icon-512.png, andicon-mask.pngfor Android devices; the first two for display on the home screen and on splash screen while the PWA is loading, respectively, and the last one for different Android launchers.
Vips or ImageMagick are required. If both are present, FaviconFactory defaults to Vips.
Vips:
brew install vipssudo apt-get install libvips
sudo apt-get install libvips-toolsImageMagick:
brew install imagemagicksudo apt-get install imagemagick # consider https://github.com/SoftCreatR/imei/Add favicon_factory to the Gemfile:
bundle add favicon_factoryOr just install the executable:
gem install favicon_factoryTo generate the favicons:
favicon_factory samples/favicon.svg
# Info: Generating samples/favicon.ico
# Info: Generating samples/icon-192.png
# Info: Generating samples/icon-512.png
# Info: Generating samples/icon-mask.png
# Info: Generating samples/apple-touch-icon.png
# Info: Generating samples/manifest.webmanifest
# Info: Add the following to the `<head>`
# <!-- favicons generated with the favicon_factory gem -->
# <link rel="icon" href="/favicon.svg" type="image/svg+xml">
# <link rel="icon" href="/favicon.ico" sizes="32x32">
# <link rel="apple-touch-icon" href="/apple-touch-icon.png">
# <link rel="manifest" href="/manifest.webmanifest">To show all the options:
favicon_factory --helpSee the samples in samples/.
To recreate them:
docker run -v $(pwd):/usr/src/app $(docker build -q .) bash -c "bin/favicon_factory -b '#ffffff' samples/github.com/vips/favicon.svg"
docker run -v $(pwd):/usr/src/app $(docker build -q .) bash -c "unpath libvips unpath libvips-tools unpath vips bin/favicon_factory -b '#ffffff' samples/github.com/image_magick/favicon.svg"
docker run -v $(pwd):/usr/src/app $(docker build -q .) bash -c "bin/favicon_factory -b '#f5ebdb' samples/rictionary/vips/favicon.svg"
docker run -v $(pwd):/usr/src/app $(docker build -q .) bash -c "unpath libvips unpath libvips-tools unpath vips bin/favicon_factory -b '#f5ebdb' samples/rictionary/image_magick/favicon.svg"After checking out the repo, run bin/setup to install the dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub.
The gem is available as open source under the terms of the MIT License.
This gem was inspired by an article on Evil Martians.