Material Icon Theme
Get the Material Design icons into your VS Code.
File icons
Folder icons
Customize folder color
You can change the color of the default folder icon using the command palette:
or via user settings:
"material-icon-theme.folders.color": "#ef5350",
Folder themes
You can change the design of the folder icons using the command palette:
or via user settings:
"material-icon-theme.folders.theme": "specific"
Custom icon opacity
You can set a custom opacity for the icons:
"material-icon-theme.opacity": 0.5
Custom icon saturation
If colors do not make you happy you can change the icons to have less saturation making them look grayish or completely grayscale by setting saturation to 0:
"material-icon-theme.saturation": 0.5
Custom icon associations
You can customize the icon associations directly in the user settings.
File associations
With the *.[extension]
pattern you can define custom file icon associations. For example you could define an icon for *.sample
and every file that ends with .sample
will have the defined icon. Use **.[extension]
with two asterisks to apply the file association also for the filenames ending with that file extension.
If there's no leading *
it will be automatically configured as filename and not as file extension.
"material-icon-theme.files.associations": {
"*.ts": "typescript",
"fileName.ts": "angular"
}
Custom SVG icons
It's possible to add custom icons by adding a path to an SVG file which is located relative to the extension's dist folder. For example a custom SVG file called "sample.svg" can be placed in an icons folder next to VS Code's extensions folder:
.vscode
┣ extensions
┗ icons
┗ sample.svg
In the settings.json the icon can be associated to a file name or file extension like this:
"material-icon-theme.files.associations": {
"fileName.ts": "../../../icons/sample"
}
Note: The custom file name must be configured in the settings without the file ending .svg
as shown in the example above.
Folder associations
The following configuration can customize the folder icons. It is also possible to overwrite existing associations and create nice combinations. For example you could change the folder theme to "classic" and define icons only for the folder names you like.
"material-icon-theme.folders.associations": {
"customFolderName": "src",
"sample": "dist"
}
Custom SVG folder icons
Similar to the files, it is also possible to reference your own SVG icons for folder icons. Here it's important to provide two SVG files: one for the folder if it's closed and another one for the opened state. These two files - let's call them "folder-sample.svg" and "folder-sample-open.svg" - have to be placed into a directory which is relative to the extensions dist folder. In our example we place them into an icons folder inside of the .vscode folder:
.vscode
┣ extensions
┗ icons
┣ folder-sample.svg
┗ folder-sample-open.svg
In the settings.json the folder icons can be associated to a folder name (e.g. "src") like this:
"material-icon-theme.folders.associations": {
"src": "../../../../../icons/folder-sample"
}
Language associations
With the following configuration you can customize the language icons. It is also possible to overwrite existing associations.
"material-icon-theme.languages.associations": {
"languageId": "iconName",
"json": "json"
}
Available language ids:
https://code.visualstudio.com/docs/languages/identifiers#_known-language-identifiers
You can see the available icon names in the overview above.
One-click activation
After installation or update you can click on the 'Activate'-button to activate the icon theme, if you haven't already. The icons will be visible immediately.
Commands
Press Ctrl-Shift-P
to open the command palette and type Material Icons
.
Command | Description |
---|---|
Activate Icon Theme | Activate the icon theme. |
Change Folder Color | Change the color of the folder icons. |
Change Folder Theme | Change the design of the folder icons. |
Change Opacity | Change the opacity of the icons. |
Change Saturation | Change the saturation value of the icons. |
Configure Icon Packs | Select an icon pack that enables additional icons (e.g. for Angular, React, Ngrx). |
Hide Folder Arrows | Hides the arrows next to the folder icons. |
Restore Default Configuration | Reset the default configurations of the icon theme. |
Toggle Grayscale | Sets the saturation of the icons to zero, so that they are grayscale. |
Icon sources
- Material Design Icons
- official icons
Contributors
![Contributors](https://raw.githubusercontent.com/PKief/vscode-material-icon-theme/master/images/contributors.png)
Would you like to contribute?
Take a look at the contribution guidelines and open a new issue or pull request on GitHub.