#ico #converter

app icogen

Quickly convert image files into Windows .ico files

3 stable releases

1.2.0 Jan 21, 2023
1.1.0 Aug 4, 2022
1.0.0 Aug 4, 2022

#181 in Images

22 downloads per month


216 lines


Quickly convert image files into Windows .ico files

Crates.io license maintenance

I often need to convert an image into a .ico file and often turn to some web-based service to do this (just drag and drop the image, out comes a .ico, etc). I shouldn't have to go online to do this quickly and easily, hence this tool. It is small and only does 1 thing, and will only ever do one thing, by design. This is a thin CLI wrapper around the image crate.


icogen 1.2.0
Kenton Hamaluik <kenton@hamaluik.ca>
Quickly convert image files into Windows .ico files

    icogen.exe [OPTIONS] <IMAGE>

    <IMAGE>    The image file to convert

    -f, --filter <FILTER>    Which resampling filter to use when resizing the image [default: cubic] [possible values: nearest, triangle, cubic, gaussian, lanczos]
    -h, --help               Print help information
    -o, --out <OUT>          The output file to write to, defaults to "<filename>.ico"
    -s, --sizes <SIZES>      What sizes of icon to generate [default: 16 20 24 32 40 48 64 96 128 256]
        --stop-on-warning    If enabled, any warnings will stop all processing
    -V, --version            Print version information

Supported File Formats

Basically what image supports for decoding, plus SVG:

  • SVG
  • PNG
  • JPEG
  • GIF
  • BMP
  • ICO
  • TIFF (baseline (no fax support) + LZW + PackBits)
  • WebP
  • AVIF (only 8-bit)
  • PNM (PBM, PGM, PPM, standard PAM)
  • DDS (DXT1, DXT3, DXT5)
  • TGA
  • OpenEXR (Rgb32F, Rgba32F (no dwa compression))
  • farbfeld


From crates.io (assuming you have Rust installed):

$ cargo install icogen

Otherwise, some pre-compiled binaries should be available on GitHub: https://github.com/hamaluik/icogen/releases/


~349K SLoC