makewindowsicons 0.1.19

Easily create all appropriate icon sizes for a Windows app from a single source image

Make Windows Icons

This script resizes a given image to various sizes and creates a set of icons for a Windows application. The generated icons are saved in PNG format, and an ICO file is created that packs all the icons together.

Features

• Resize a single source image to multiple sizes.
• Save the resized images in PNG format.
• Create an ICO file containing all the resized icons.
• Optionally, specify additional sizes to resize the image to.

Requirements

• Python 3.11+

Installation

1. Install with pip:

python3 -m pip install makewindowsicons

Usage

python3 -m makewindowsicons <input_image> <app_name> [--output_dir <output_directory>] [--no_dir] [-s <size>]...

Arguments

• <input_image>: Path to the source image.

Options

• <app_name>: Name of the application. Default is 'app'.
• --output_dir <output_directory>: Directory to save the output resources. Default is the current directory.
• --no_dir: Do not create a 'resources' directory; save images directly to the specified output directory.
• -s <size>, --size <size>: Additional sizes to resize the image to. Can be specified multiple times.

Examples

1. Default behavior:

   Resize the image to the default sizes and save in the resources directory within the current directory:

   python3 -m makewindowsicons your_source_image.png YourAppName
   

2. Specify output directory:

   Resize the image to the default sizes and save in the resources directory within the specified output directory:

   python3 -m makewindowsicons your_source_image.png YourAppName --output_dir output_path
   

3. Without creating resources directory:

   Resize the image to the default sizes and save directly in the specified output directory:

   python3 -m makewindowsicons your_source_image.png YourAppName --output_dir output_path --no_dir
   

4. Add additional sizes:

   Resize the image to the default sizes plus additional sizes (e.g., 37px, 69px, 420px) and save in the resources directory within the specified output directory:

   python3 -m makewindowsicons your_source_image.png YourAppName --output_dir output_path -s 32 -s 72 -s 128
   

Contributing

Feel free to submit issues or pull requests if you find any bugs or have suggestions for improvements.

License

This project is licensed under the MIT License. See the LICENSE file for details.