Go to file
2023-06-03 21:54:58 +03:00
generate.sh Update generate.sh 2020-05-12 21:38:33 +03:00
LICENSE Initial commit 2019-07-09 09:54:49 +03:00
Makefile Fix makefile OS compatibility 2021-10-17 19:33:13 +03:00
README.md Update README.md 2023-06-03 21:54:58 +03:00

All-in-one favicon generator

Generates all necessary favicons for your website. This includes iOS Safari, Google Chrome, Mozilla Firefox, Windows 8 and 10, and possibly some other browsers.

Getting Started

To get started with favicon generator you need to make sure ImageMagick and the latest GNU make software are installed and present in your PATH environment variable.

Configuration

By default, makefile uses convert file of ImageMagick software, but you can change that by specifying a new name as a parameter for make

make CC=<executable name>

or by changing the following line in a makefile

CC = convert

Also, the default image filename make is looking for is source.png, and you can change that either passing the new filename as a parameter

make SOURCE=<image filename>

or by changing the following line

SOURCE ?= <image filename>

Using bash

You use bash script generate.sh to use the program anywhere on your system. First of, you have to create a symbolic link to an executable using the following command

$ ln -s <path to program>/generate.sh ~/.local/bin/webicongen
# example: ln -s ~/Programs/Favicons_generation/generate.sh ~/.local/bin/webicongen

then you can use it in such a way

$ webicongen <image> <output dir>

The output directory will be created automatically.

Usage

After everything is configured, simply place your image in the same directory as makefile, and then simply run make. It will generate the following directory structure

dist/
├── public/
│   ├── apple-touch-icon.png
│   ├── apple-touch-icon-precomposed.png
│   ├── favicon.ico
│   ├── icons/
│   │   ├── android-chrome-192x192.png
│   │   ├── android-chrome-512x512.png
│   │   ├── apple-touch-icon-114x114.png
│   │   ├── apple-touch-icon-120x120.png
│   │   ├── apple-touch-icon-144x144.png
│   │   ├── apple-touch-icon-152x152.png
│   │   ├── apple-touch-icon-57x57.png
│   │   ├── apple-touch-icon-60x60.png
│   │   ├── apple-touch-icon-72x72.png
│   │   ├── apple-touch-icon-76x76.png
│   │   ├── apple-touch-icon.png
│   │   ├── favicon-128x128.png
│   │   ├── favicon-16x16.png
│   │   ├── favicon-192x192.png
│   │   ├── favicon-196x196.png
│   │   ├── favicon-228x228.png
│   │   ├── favicon-32x32.png
│   │   ├── favicon-48x48.png
│   │   ├── favicon-57x57.png
│   │   ├── favicon-76x76.png
│   │   ├── favicon-96x96.png
│   │   ├── ieconfig.xml
│   │   ├── mstile-144x144.png
│   │   ├── mstile-large.png
│   │   ├── mstile-medium.png
│   │   ├── mstile-small.png
│   │   └── mstile-wide.png
│   └── manifest.json
└── source.html

source.html contains HTML code that needs to be pasted in your document's head.