Material Theme, the most epic theme for Visual Studio Code
Clone or download

README.md

Twitter GitHub tag

The most epic theme meets Visual Studio Code. You can help by reporting issues here

Getting started

You can install this awesome theme through the Visual Studio Code Marketplace.

Installation

Launch Quick Open

Paste the following command and press Enter:

ext install vsc-material-theme

Packaged VSIX Extension

Download the latest .vsix release file from the marketplace and install it from the command line

code --install-extension vsc-material-theme-*.*.*.vsix

or from within VS Code by launching Quick Open and running the Install from VSIX... command.

GitHub Repository Clone

Change to your .vscode/extensions VS Code extensions directory. Depending on your platform it is located in the following folders:

  • Linux ~/.vscode/extensions
  • macOs ~/.vscode/extensions
  • Windows %USERPROFILE%\.vscode\extensions

Clone the Material Theme repository as Equinusocio.vsc-material-theme:

git clone https://github.com/equinusocio/vsc-material-theme.git Equinusocio.vsc-material-theme

Activate theme

Launch Quick Open,

Type theme and choose Preferences: Color Theme, then select one of the Material Theme variant from the list. After the activation the theme will set the correct icons theme for you, based on your picked theme variant.

Fix File Icons

If you notice that the folder icons does not match the material theme active variant you can fix it with just a command.

Launch Quick Open,

type material theme and select Material Theme: Fix file icons from the drop-down menu, this command will set the correct icon theme based on your active material theme variant.

Set the accent color

Launch Quick Open,

Type material theme and choose Material Theme: Set accent color and pick one color from the list.

Disabling/enabling file icons auto-applying

By default material theme will apply the correct icons theme based on your active theme variant. To disable this behavior follow these steps:

Launch Quick Open,

Type material theme and choose Material Theme: Enable or disable icons auto-applying and choose to disable or enable this behavior.

Override theme colors

You can override the material theme ui and schemes colors by adding these theme-specific settings to your configuration. For advanced customisation please check the relative section on the vs code documentation

Color Scheme override

Basic example

"editor.tokenColorCustomizations": {
    "[Material Theme]": {
        "comments": "#229977"
    }
},

Advanced example

"editor.tokenColorCustomizations": {
    "[Material Theme VARIANT]": {
        "sideBar.background": "#347890",
        "textMateRules": [
            {
                "scope": [
                    "punctuation.definition.comment",
                    "comment.block",
                    "comment.line",
                    "comment.block.documentation"
                ],
                "settings": {
                    "foreground": "#FF0000"
                }
            }
        ]
    },
},

Recommended settings for a better experience

{
    // Controls the font family.
    "editor.fontFamily": "Operator Mono",
    // Controls the line height. Use 0 to compute the lineHeight from the fontSize.
    "editor.lineHeight": 24,
    // Enables font ligatures
    "editor.fontLigatures": true,
    // Controls if file decorations should use badges.
    "explorer.decorations.badges": false
}

Official Portings

Thanks to the Material Theme community you can use is with other softwares, here the official portings:

Other resources

  • AppIcon: Download the official Material Theme app icon for Visual Studio code

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]


Copyright © 2017 Mattia Astorino