Icon groups

With ACYLS colors setting for different icon group can be configured separately. There are several icon groups by default ("All (except emblems)", "Emblems", "Custom" etc.) and you can add your own. Icon groups can be customized in scripts/data/user/config.ini configuration file.

Add Simple Icon Group

Simple group is solid and non customizable (e.g. "All (except emblems)", "Emblems"). To create new group you should define directory with real icons, directory with preview icon and group name. For example, add this section to you config

[IconGroup5]
# Group name
name = All
# Directory with main preview icon
testdirs = scripts/preview/main
# Real icons directory
realdirs = scalable/real_icons
# Directory with reserved preview icon
emptydir = scripts/preview/unknown
# This is simple group
custom = False

Add Custom Icon Group

Custom group can be controlled by user ("Alternative", "Custom" etc.), meaning you can select one or several icon subgroup. Take a look at 'Alternative' icon group settings

[IconGroup4]
# Group name
name = Alternative
# Directory with reserved preview icon
emptydir = scripts/preview/unknown
# Root directory for preview icons
testbase = scripts/preview/alternative
# Root directory for real icons
realbase = scalable/alternative_icons
# This is custom group
custom = True

Main difference that real and preview directories containing not simple icons but a pack of subdirectories. Here a quick example how to create new custom icon group. Let it be an abstract media player, which has two icon subgroup: 'logo' and 'buttons'.

First thing lets create real icons directories (WARNING: only lowercase naming allowed)

$ cd ~/.icons/ACYLS/
$ mkdir scalable/player
$ mkdir scalable/player/logo
$ mkdir scalable/player/buttons

and place some icons there.

$ cp scalable/real_icons/apps/smplayer.svg scalable/player/logo/
$ cp scalable/real_icons/actions/gtk-media-* scalable/player/buttons/

Now we should make preview directory with same structure as real icons root folder and place one icon for every subgroup.

$ mkdir scripts/preview/player
$ mkdir scripts/preview/player/logo
$ mkdir scripts/preview/player/buttons
$ cp scalable/player/logo/smplayer.svg scripts/preview/player/logo/
$ cp scalable/player/buttons/gtk-media-next-ltr.svg scripts/preview/player/buttons/

Last step: add new group description to config.ini

[IconGroup5]
name = Player
emptydir = scripts/preview/unknown
testbase = scripts/preview/player
realbase = scalable/player
custom = True

It's done. Now you can run configuration program a and play with new icon group.

What About Other Options?

There are several specific option for icon groups, which does not assume common using.

• emptydir - this is some kind of "spare" for preview icon directory. Originally icon from this directory was used to be shown when no one custom icon group option selected. But then it also implement as replacement when some of preview icons missed, so now it useful for simple icon group too. As you can see this option is the same for all bundled icon groups.
• pairdir - this is directory with second preview icon. ACYLS allow use composite of two icons as preview. it may useful for very special icons group like "Emblems".
• pairsw - used only with "double preview" icon group which descriptive above and allow you swap main and second preview icon.