material-theme/vsc-community-material-theme

Communication ⚠️

This project is community-maintained. You can find the official Material Theme here.

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

Communication ⚠️
Getting started
- Installation
  - GitHub Repository Clone
Activate theme
Override theme colors
- Color Scheme override
Recommended settings for a better experience
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

// Overrides colors
"workbench.colorCustomizations": {
    "[Community Material Theme VARIANT]": {
        "sideBar.background": "#ff0000",
    }
},

// Overrides editor syntax colors and font style
"editor.tokenColorCustomizations": {
    "[Community Material Theme VARIANT]": {
        "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"
                }
            }
        ]
    },
},

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

material-theme / vsc-community-material-theme