A File Icon

This Sublime Text package ...

1. provides basic infrastructure to select and customize file icon themes.
2. ships colored and monochrome file icons, heavily inspired by Atom File Icons.

Installation

Package Control

The easiest way to install is using Sublime's Package Control. It's listed as A File Icon.

1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
2. Run Package Control: Install Package
3. Find A File Icon and hit Enter

Manual Install

1. Download AFileIcon.sublime-package
2. Rename it to A File Icon.sublime-package
3. Copy it into Installed Packages directory

Note

To find Installed Packages...

1. call Menu > Preferences > Browse Packages..
2. Navigate to parent folder

Usage

Select Icon Theme

1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
2. Run UI: Select Icon Theme
3. Choose a theme and hit Enter

Customize Icon Theme

1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
2. Run UI: Customize Icon Theme
3. Choose a theme and hit Enter

An icon theme maps file extension to image names in the following format:

{
    "icons": {
        "extension": "icon_file_name",
    }
}

Customize Icon Settings

To change color, opacity level and size of icons, modify A File Icon settings:

1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
2. Run Preferences: A File Icon Settings

Note

Settings are applied globally to all icon themes.

Theme Developers

As of Sublime Text 4206 dedicated icon themes are supported, which A File Icon 4.0 relies on.

A side effect is it no longer merging its icons into those shipped with themes.

Ideally, icon themes are deployed by dedicated packages to fully separate them from themes or color schemes.

If theme packages ship icons, a related .sublime-file-icons file is to be defined for them to be selectable by end users.

The .supports-a-file-icon-customization is still evaluated to decide how to create icon related theme patches as former versions of A File Icons did.

Resources

Colors

Colors are bright because they should look good with most themes. However you can change color and opacity level of all icons. See customization.

Icons

This package contains icons provided by:

• Atom File Icons
• Devicons
• Font Awesome
• Font Mfizz
• Icomoon
• Octicons

Source icons are provided in SVG format (Sublime Text doesn't currently support it). They are convert to @1x and @2x PNG assets before each release via python build script uv run build --icons.

Rasterized icons can be found in icons folder.