vsc-material-theme

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

• Getting started
  • Installation - Packaged VSIX Extension - GitHub Repository Clone
  • Activate theme
  • Fix File Icons
  • Set the accent color
  • Disabling/enabling file icons auto-applying
  • Override theme colors
    • Color Scheme override
• Recommended settings for a better experience
• Official Portings
• Other resources
  • Contributors
  • Backers
  • Sponsors

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 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,

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

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,

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

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,

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

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,

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

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:

• Atom Editor: atom-material-ui (by @silvestreh)
• IntelliJ IDEA (thanks to @ChrisRM and @mallowigi).
• Vim (thanks to @hzchirs).
• Terminal OSX (thanks to @mvaneijgen).
• iTerm2 (by @Revod) and iTerm2 Palenight (by @jonathanspeek).
• Hyper.
• ConEmu (thanks to @rajadain).
• Slack App ( #263238,#2e3a40,#80CBC4,#FFFFFF,#13191C,#ffffff,#50fa7b,#FF5555 )
• Nylas N1 (thanks to @jackiehluo)
• Base16 (by @ntpeters)

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