ico
Convert images to Windows icon format
TLDR
Display the wireframe of an icosahedron that changes its position every 0.1 seconds
Display a solid icosahedron with red faces on a blue background
Display the wireframe of a cube with size 100x100 that moves by +1+2 per frame
Display the inverted wireframe of an icosahedron with line width 10 using 5 threads
SYNOPSIS
icotool [OPTIONS] [FILE...]
Examples of usage:
icotool -l iconfile.ico
icotool -x iconfile.ico --save-dir extracted_icons
icotool -c -o new_icon.ico --icon-size 32 --bit-depth 24 image1.png image2.png
PARAMETERS
-l, --list
List the contents of the specified ICO or CUR files.
-x, --extract
Extract images from the specified ICO or CUR files.
-c, --create
Create a new ICO or CUR file from input images.
-o FILE, --output=FILE
Specify the output file name for creation or extraction.
-r N, --index=N
Select a specific image index for extraction or creation.
-i FILE, --input=FILE
Specify input image files for creation (can be multiple).
-s N, --icon-size=N
Set the output icon/cursor image size during creation (e.g., 16, 32, 48).
-b N, --bit-depth=N
Set the bit depth for the output image during creation (e.g., 24, 32).
-t TYPE, --type=TYPE
Set the type of file to create: icon or cursor.
--save-dir=DIR
Specify the directory where extracted images should be saved.
--names=FORMAT
Control the naming format of extracted files.
--force
Overwrite existing files without prompting.
--verbose
Produce more detailed output.
--help
Display a help message and exit.
--version
Output version information and exit.
DESCRIPTION
icotool is a command-line utility from the icoutils package designed for working with Microsoft Windows icon (.ico) and cursor (.cur) files. It provides functionalities to list the contents of such files, extract individual images from them, and create new ICO or CUR files from various input images (e.g., PNG, BMP). This tool is crucial for developers and users needing to manage Windows-specific graphical resources on non-Windows operating systems, facilitating cross-platform asset management. It supports multiple image formats, bit depths, and sizes, making it versatile for icon and cursor creation and manipulation. icotool helps bridge the gap for handling these proprietary formats within a Linux environment.
CAVEATS
The command ico is not a standard or widely recognized standalone utility in typical Linux distributions. This analysis primarily refers to icotool, a component of the icoutils package, which is the actual command-line tool for manipulating Windows ICO and CUR files. Users might encounter ico as an alias or a custom script on specific systems, but for general use and installation, icotool is the correct command.
CLARIFICATION ON 'ICO' COMMAND
It's important to note that a standalone command named 'ico' is not standard on most Linux distributions. The functionality typically associated with managing .ico files is provided by the icotool utility, which is part of the icoutils package. If you encountered 'ico' on a specific system, it might be a custom alias, a symlink, or a very niche script. For general purposes, always refer to and install icotool when needing to work with Windows icon and cursor files.
HISTORY
icotool emerged as part of the icoutils project, specifically designed to address the need for manipulating Windows icon and cursor files on Unix-like operating systems. This suite of tools fills a crucial gap for cross-platform development and content management, allowing Linux users to create, extract, and inspect .ico and .cur files without relying on Windows-specific software. Its development has been driven by the need for open-source tools to handle these proprietary binary formats, contributing to the broader ecosystem of free software utilities.
SEE ALSO
convert(1) (ImageMagick), identify(1) (ImageMagick), xcursorgen(1)