License:      MIT License
Source:       https://github.com/Kwezza/IconSync

Easily Replace Missing Folder Icons

A common problem I've had when extracting numerous WHDLoad archives, 
particularly when using the companion program WHDArchiveExtractor, is ending
up with folders that have missing icons or icons that don't match my 
preferred colour scheme. This simple command-line program solves that by 
allowing you to copy your custom icons into those folders.

How It Works:

* Designed primarily for use after running WHDArchiveExtractor to extract 
* WHDLoad archives, but can be used with any folder.
* Requires two folders:
  - A target folder containing the folders you want to replace or create
    icons for.
  - A source icon folder with your custom icon set (.info files).
* The icon set should include icons for A-Z (A.info - Z.info) and 0 (0.info)
  for numbered folders.
* You can also include other custom icons for specific folders like 
  Games.info, Demos.info, AGA.info, etc.
* If a folder doesn't match any icons in the source, a default "Blank.info"
  icon is copied and renamed.
* Skips folders containing .slave files to avoid changing the look made by 
  the WHDLoad game author.

Program Features:

* DeleteGameFolderIcons: Removes existing icons for game folders (with 
  .slave files inside) and replaces them with the "Blank.info" icon for a 
  uniform look.
* DeleteExistingIcons: Deletes icons in the target folder if a matching
  icon exists in the source folder before replacing them.

Important Notes:

* You need to provide your own custom icon set - it's not (yet) included
  with the program.
* If source icons have been "snapshotted" (locked positions), their 
  positions will be replicated when copied, which could lead to
  misalignment.  Icons should be unsnapshotted.  I've found that sometimes
  Workbench won't allow you to unshapshot a folder icon unless you have an
  actual folder to go with it.
* Don't snapshot the "default.info" icon to avoid clustering all game
  folders together one on top of each other.
* This program makes changes to your icons, so make sure you can revert if 
  needed.


Usage:
$ IconSync <target_directory> <icon_source_directory> 
           [-DeleteGameFolderIcons] [-DeleteExistingIcons]

By using this program after extracting WHDLoad archives with 
WHDArchiveExtractor, you can easily get all your extracted folders to look 
consistent with your preferred icon theme.


CHANGELOG:
[1.0.0] - 2024-03-28
- First release

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 6651   10784  61.7% -lh5- 124f Mar 28 15:42 IconSync
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         1 file     6651   10784  61.7%            Apr  3 00:25