img2ico

A simple CLI tool and Python library to convert images into multi-resolution favicon (.ico) files.

Features

• Convert PNG, JPG, WEBP, BMP to ICO
• Optional SVG support (requires cairosvg)
• Embed multiple icon sizes in one .ico file (16x16, 32x32, 48x48 by default)
• Easy to use CLI and Python API

Installation

pip install pillow
# Optional: for SVG input support
pip install cairosvg

Or if you publish this as a package:

pip install img2ico
# with SVG support
pip install img2ico[svg]

Usage

CLI

img2ico input.png -o favicon.ico -s 16 32 48

Options:

Python API

from pathlib import Path
from img2ico import convert_to_ico

convert_to_ico(
    input_path=Path("logo.png"),
    output_path=Path("favicon.ico"),
    sizes=[(16, 16), (32, 32), (48, 48)],
)

Recommended Sizes

For favicon usage, it is recommended to include:

• 16x16 – browser tab, old browsers
• 32x32 – high DPI displays
• 48x48 – Windows desktop icons

You can also add 64x64 or larger if you want to future-proof, but it is not strictly necessary.

Development

Clone the repository and install dependencies:

git clone https://github.com/yourname/img2ico.git
cd img2ico
pip install -e ".[svg]"

Run tests or try the CLI:

python -m img2ico input.png

License

MIT