This package adds file-specific icons to Sublime Text for improved visual grepping. It's heavily inspired by Atom File Icons.
Its aims are:
- To be a
tmPreferencesstorage for UI themes those support file-specific icons.
- To provide icons for themes those don't (fully) support file-specific icons.
If you have any problems, please search for a similar issue first, before creating a new one.
Also, check the list of known issues before doing so.
The easiest way to install is using Sublime's Package Control. It's listed as
A File Icon.
Command Paletteusing menu item
Tools → Command Palette...
Package Control: Install Package
A File Iconand hit
- Download the
- Unzip and rename folder to
A File Icon
- Copy folder into
Packagesdirectory, which you can find using the menu item
Preferences → Browse Packages...
Note: Don't forget to restart Sublime Text after installing this package.
You can change the color, opacity level and size of the icons by modifying your user preferences file, which you can find by:
Preferences → Package Settings → A File Icon → Settings,
A File Icon: Settingsin
Sublime Text uses syntax scopes for file-specific icons. That's why icons of packages provided by the community require them to be installed.
See the list of community packages that you may need to install to see the right icon.
If your theme supports an icon customization you can choose what icons you want to use – provided by the theme (by default) or provided by the package. Otherwise this package adds its own icons only.
Themes that already have support of the icon customization include:
If something goes wrong try to:
Command Paletteusing menu item
Tools → Command Palette....
A File Icon: Revert to a Freshly Installed State.
- Restart Sublime Text.
Bring Support of the File Icon Customization to Your Theme
If you are a theme developer and you want to support a file icon customization, you should:
- Remove all stuff related to the icon setup:
- Rename all your existing icons to match these ones.
.supports-a-file-icon-customizationfile to the root of your theme (this is how we check if the theme supports customization of the file-specific icons).
- Also you can provide this script which recommends user to install
A File Iconfor enhanced support of the file-specific icons.
How It Works
In simple terms,
A File Icon does the following:
- Copies all the necessary files right after install or upgrade to
zzz A File Icon zzzdirectory
- Searches all installed themes
- Checks if themes are already patched, if not
- Patches them by generating
<theme-name>.sublime-themefiles from a template
- For themes those support file icon customization, it provides
.tmPreferencesfiles and missing icons by default (user can override icons provided by the theme via
The real process is just a little bit more complex to minimize hard drive I/O.
Want to contribute some code? Excellent! Read up on our guidelines.
This package contains icons provided by:
Source icons are provided in SVG format (Sublime Text doesn't currently support it). We convert them to @1x and @2x PNG assets before each release via a custom
Rasterized icons can be found in
Share The Love
I've put a lot of time and effort into making A File Icon awesome. If you love it, you can buy me a coffee. I promise it will be a good investment
Donate with: Patreon.