Communication ⚠️

This project is community-maintained and the source is encrypted. If you want to maintain it and ship new fixes, ask to become a maintainer so you'll have full access to the repository.

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

• Getting started
  • Installation
    • GitHub Repository Clone
• Activate theme
• Override theme colors
  • Color Scheme override
• Recommended settings for a better experience
• Official Portings
• Other resources

Getting started

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

Installation

Launch Quick Open:

• Linux Ctrl+P
• macOS ⌘P
• Windows Ctrl+P

Paste the following command and press Enter:

ext install material theme

And pick the one by Mattia Astorino (Equinusocio) (me) as author.

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-community-material-theme:

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

Activate theme

Launch Quick Open:

• Linux Ctrl + Shift + P
• macOS ⌘ + Shift + P
• Windows Ctrl + Shift + P

Type theme, choose Preferences: Color Theme, and select one of the Community Material Theme variants from the list. After activation, the theme will set the correct icon theme based on your active theme variant.

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": {
    "[Community Material Theme]": {
        "comments": "#229977"
    }
},

Advanced example

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

"workbench.colorCustomizations": {
	"[Community Material Theme VARIANT]": {
		"sideBar.background": "#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
}

Other resources

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