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.pngandicon-512.pngfor Android devices; the former for display on the home screen, and the latter for the splash screen while the PWA is loading.
Vips or ImageMagick+Inkscape are required. If both are present, FaviconFactory defaults to Vips.
Vips:
brew install vipssudo apt-get install libvips
sudo apt-get install libvips-toolsImageMagick and Inkscape:
brew install imagemagick
brew install inkscapesudo apt-get install imagemagick # for v7 consider https://github.com/SoftCreatR/imei/
sudo apt-get install inkscapeAdd favicon_factory to the Gemfile:
bundle add favicon_factoryOr just install the executable:
gem install favicon_factoryTo generate the favicons (see samples/ for an example set):
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/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 --helpAfter 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.