dreamega-ico-encoder

Generate .ico favicon files from any image. Multi-size support. Built by Dreamega.

Installation

pip install dreamega-ico-encoder

Usage

Generate ICO from a file

from dreamega_ico_encoder import generate_ico_from_file

# Create favicon with default sizes (16, 32, 48, 64, 128, 256)
generate_ico_from_file("logo.png", "favicon.ico")

# Custom sizes
generate_ico_from_file("logo.png", "favicon.ico", sizes=[16, 32, 48])

Generate ICO from a PIL Image

from PIL import Image
from dreamega_ico_encoder import generate_ico

img = Image.open("logo.png")
ico_bytes = generate_ico(img, sizes=[16, 32, 64, 256])

with open("favicon.ico", "wb") as f:
    f.write(ico_bytes)

Generate ICO from raw bytes

from dreamega_ico_encoder import generate_ico_from_bytes

with open("logo.png", "rb") as f:
    raw = f.read()

ico_bytes = generate_ico_from_bytes(raw, sizes=[16, 32, 48])

with open("favicon.ico", "wb") as f:
    f.write(ico_bytes)

API Reference

generate_ico(source, sizes=None) -> bytes

Generate a multi-size ICO file from a PIL Image.

Returns: bytes -- the ICO file content.

generate_ico_from_file(input_path, output_path, sizes=None) -> None

Read an image file and write an ICO file to disk.

generate_ico_from_bytes(image_bytes, sizes=None) -> bytes

Generate ICO from raw image bytes.

Returns: bytes -- the ICO file content.

DEFAULT_SIZES

DEFAULT_SIZES = [16, 32, 48, 64, 128, 256]

The default set of icon sizes used when sizes is not specified.

License

MIT -- see LICENSE.

Links

• Homepage: https://dreamega.ai