Metadata-Version: 2.1
Name: folderikon
Version: 0.0.1
Summary: attr: folderikon.metadata.__description__
Home-page: https://github.com/demberto/folderikon
Author: attr: folderikon.metadata.__author__
Author-email: demberto@protonmail.com
License: attr: folderikon.metadata.__license__
Project-URL: Bug Tracker, https://github.com/demberto/folderikon/issues
Project-URL: Changelog, https://github.com/demberto/folderikon/blob/master/CHANGELOG.md
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# FolderIkon

> A Windows utility to set folder icons.

Normally, setting a folder icon (not to be confused with a folder picture) through Windows Explorer requires an icon of ICO format, this means converting it first. Also changing the folder name will make the icon ineffective.

**FolderIkon** will take a JPG, ICO or a PNG file, convert it, create/edit the configuration file `desktop.ini`, set the appropriate permissions and [notify the Shell](https://docs.microsoft.com/windows/win32/api/shlobj_core/nf-shlobj_core-shchangenotify) about the icon. The icon will be hidden as it has generally no other use, *also it is a 256x256 image, nothing beautiful*.

However tilted images e.g those of product boxes etc. will not be displayed properly. A square image is recommended for optimum results. I suggest not to use images of other aspect ratios although they will work.

## Installation

Requires Python 3.6+ and Windows

```
pip install --upgrade folderikon
```

## Usage

Set the first ICO, JPG or PNG found in the current folder as the folder icon (subfolders not included).
```
folderikon
```

Set `image` as the folder icon of the current folder. `image` can be a URL as well.
```
folderikon -i image
```

Set `image` as the folder icon of `folder` and name the icon as `icon`
```
folderikon -i image -d folder -o icon
```

Extended usage information:
```
folderikon [-h] [--image IMAGE] [--icon ICON] [--folder FOLDER] [--delete-original] [--raise-on-existing] [--dont-hide-icon] [--silent] [--no-color]

A Windows utility to set folder icons.

optional arguments:
  -h, --help            show this help message and exit
  --image IMAGE, --input IMAGE, -i IMAGE
                        The image to set as folder icon. JPG, ICO and PNG formats are supported. URLs can be specified as well. Defaults to the       
                        first JPG/PNG file found in the current folder.
  --icon ICON, --output ICON, -o ICON
                        Output icon file name. Defaults to the name of first JPG/PNG found in current folder saved with a '.ico' extension.
  --folder FOLDER, -d FOLDER
                        The path of the folder whose icon is to be set. Defaults to the current folder.
  --delete-original, -f
                        Deletes the original image.
  --raise-on-existing   Raise an exception if the folder already has an icon.
  --dont-hide-icon      The folder icon is marked as hidden by default. Use this option to not do it.
  --no-color            Disables colored output.
```

### [TODO](TODO.md)

### [Changelog](CHANGELOG.md)

### License
MIT License

