Zukan Icon Theme

Icon theme for Sublime Text 4 editor.

Docs ・ Build ・ File icon ・ Plugin ・ Theme ・ Troubleshooting

File icons in v0.4.3

All file icons, see file-icon.md

Install

The recommended way to install is through PackageControl.io.

• Menu Tools > Command Palette > Package Control: Install Package
• Type Zukan, search for Zukan Icon Theme
• Click to install it
• Restart ST if installation do not prompt start, or all icons do not show in current theme.

To install manually:

• Download the latest release or clone this repo.
• Menu Sublime Text > Preferences > Browse packages... to open destination folder
• Then unzip zukan-icon-theme zip file inside Packages folder. Or clone the repo inside Packagesfolder.
• Rename folder Zukan-Icon-Theme to Zukan Icon Theme. This is important for Main.sublime-menu and tests.

Mac/Linux $ git clone https://github.com/53v3n3d4/Zukan-Icon-Theme.git Zukan\ Icon\ Theme
Windows $ git clone https://github.com/53v3n3d4/Zukan-Icon-Theme.git "Zukan Icon Theme"

You may see a console message, regarding ruamel-yaml dependecy, when first install this package. ST may install it and inform that a restart is needed.

ruamel-yaml is being used to create icons sublime-syntaxes files in icons-syntaxes folder.

If new install, the default is to create all icons files and make them show on all themes installed.

Theme

If you do not want icons in a specific theme. You can delete the icon theme, go to Tools > Command Palette.... Type zukan and select Zukan Icon Theme: Delete Theme.

This option deletes all icons preferences and syntaxes files. So when you move to a theme that you want icons, it will rebuild all files.

If you prefer to create or delete a theme manually, see theme.md.

Uninstall

To remove package using Package Control.

• Menu Tools > Command Palette > Package Control: Remove Package
• Click on Zukan Icon Theme

To uninstall manually, go to your Sublime Text folder.

• Menu Sublime Text > Preferences > Browse packages...
• Then delete Zukan Icon Theme inside Packages folder

Dependecies

ST4 uninstall unused dependencies. So dependency ruamel-yaml should be deleted when you uninstall/remove package, if not used by other packages.

Upgrade

Package Control, by default, auto upgrade packages plugins. So this package will get icons PNGs and data file auto upgraded. Icons preferences and syntaxes are built based on user syntaxes and themes installed.

We are auto upgrading icons preferences and syntaxes by default.

You can disable it, go to menu Sublime Text > Settings > Package Settings > Zukan Icon Theme > Settings and change rebuild_on_upgrade to false.

Icons that do not work

• Favicon. ST use file_type_image icon for binary files. favicon.svg works.
• Photoshop. ST use file_type_image icon
• XML. ST use file_type_markup icon

ST Package syntaxes that are using generic icon

• DTD use file_type_markup
• XSL use file_type_markup

Troubleshooting

If icons does not prompt show correct, restart ST may be the solution. See troubleshooting.md

Notes

• This package uses tmPreferences and sublime-syntax files, it is heavily based on how A File Icon package make icons work
• file-type-icons is old project name
• If rename file-type-icons to v-file-type-icons, and make the last folder in Packages directory, sublime icons will work
• If rename file-type-icons to z-file-type-icons, and make the last folder in Packages directory, is not enough for svg icon to work. It was needed zz-file-type-icons to make svg icon work

Icons that works depending on folder position

• Poetry
• SVG
• sublime-theme, sublime-color-scheme, sublime-settings... mostly sublime (Exceptions like hidden-theme works not depending on this condition)

File icon packages 👽

• A File Icon
• FileIcons

License

MIT license (LICENSE-MIT)