Metadata-Version: 2.1
Name: makewindowsicons
Version: 0.1.19
Summary: Easily create all appropriate icon sizes for a Windows app from a single source image
Home-page: https://github.com/djstompzone/MakeWindowsIcons
License: MIT
Author: DJ Stomp
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: argparse (>=1.4.0,<2.0.0)
Requires-Dist: pillow (>=10.4.0,<11.0.0)
Project-URL: Repository, https://github.com/djstompzone/MakeWindowsIcons
Description-Content-Type: text/markdown

# 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:

```sh
python3 -m pip install makewindowsicons
```

## Usage

```sh
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:

   ```sh
   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:

   ```sh
   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:

   ```sh
   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:

   ```sh
   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](LICENSE) file for details.
