These settings allow you to customize the file status colors on a per color scheme basis.
File Status Colors is a feature of the IDE to colorize certain parts of the UI displaying a file according to its status. Some of the most obvious examples are:
- Project View
- Editor Tabs
- Recent Files
- Navigate to file/class/symbol
By status means relatively to version control systems, such as modified files, newly added files, deleted files, ignored files or conflicted files, for instance.
Originally these color settings were found inside the
Color Schemes section of the settings, allowing color schemes
designers to set their own file status colors, but at some point JetBrains decided to remove this ability, having judged
that it doesn’t make sense to have colors affecting the UI found inside settings affecting the editor.
While it does make sense, it was still a good thing to let people change these colors according to their themes. Why
wouldn’t the Monokai theme creator change the
Modified Files color to his shade of cyan? Or the
files to his shade of magenta? A lot of scheme designers supplied those colors so why remove this feature?
So after reconsideration, JetBrains decided to let people customize file colors anyway, but instead of a per-color scheme basis, it is now per-application basis, and not provided by color scheme designers.
Therefore this ability has now moved under Version Control -> File Status Colors. But because these colors are related to the UI (e.g. IntelliJ or Darcula Look And Feel), these are not independant standalone settings but instead coupled to the relevant look and feel. That means that those colors are found inside IntelliJ or Darcula Color Scheme rather than inside application settings.
But here, at Material Theme, decided to restore that feature to again allow color scheme designers to provided their own set of file status colors!
UPDATE: Since 2019.1 JetBrains gave the ability to plugin creators to define their own custom themes, thus extending the list of available Look and Feels! And because of this decision, the File Status Colors needed to be customizable again, so they added the ability to customize the File Colors via the Color Scheme: http://www.jetbrains.org/intellij/sdk/docs/reference_guide/ui_themes/themes_extras.html#customizing-version-control-file-status-colors
But again, there’s no settings page for that, so the Material Theme File Status Colors settings still comes in handy!
Material File Colors
These settings are not found inside the
Material Theme Settings but instead in a specific section of the
Schemes, just like before.
There you can override the File Status Colors from the IntelliJ/Darcula color scheme to the ones specified by the color scheme.
Here’s an explanation of the file statuses and their default color:
|Added||#C3E88D (green)||New file added to the repository in active changelist|
|Added outside||#C3E88D (green)||New file added to the repository in non-active changelist|
|Changelist conflict||#d5756c (red)||File modified in two changelists|
|Copied||#C3E88D (green)||File copied (Mercurial only)|
|Deleted||#808080 (gray)||File removed from the repository|
|Deleted from FS||#808080 (gray)||File deleted from the file system|
|Directories||#FCFCFA (default text)||Directory (depends on the Styled Directories setting).|
|Have changed descendants||#80cbc4 (cyan)||Directory has recursively changed files (not used)|
|Have immediate changed||#80cbc4 (cyan)||Directory has immediate changed descendants (not used)|
|Hijacked||#ffcb6b (yellow)||File is modified without editing (Perforce only)|
|Ignored||#ab7967 (brown)||File is ignored|
|Ignored (ignore plugin)||#ab7967 (brown)||File is ignored by the .ignore plugin|
|Merged||#C792EA (violet)||File is modified by a merge|
|Merged with conflicts||#d5756c (red)||File has conflicts|
|Modified||#80cbcf (cyan)||File modified in active changelist|
|Modified outside||#82AAFF (blue)||File modified in non-active changelist|
|Obsolete||#ffcb6b (yellow)||File is obsolete (SVN only)|
|Renamed||#80CBC4 (cyan)||File renamed (Mercurial only)|
|Switched||#C792EA (violet)||File from another branch (SVN only)|
|Suppressed||#546E7A (comments color)||File from a Virtual File System (like Scratches)|
|Unknown||#d5756c (red)||Unversioned file|
|Up to date||none (default tree color)||File unchanged|
Note: These colors are only relevant for Material Dark themes. Other themes such as Monokai Pro or Solarized have different colors, of course.
Other statuses may come from 3rd-party plugins and will have the default color provided by the plugin.
Note: Because this feature overrides the one from the IDE, changing colors via the regular screen (
VCS -> File
Status Colors) doesn’t make sense and will be overriden the next time you change the color scheme. So please use the
Material File Colors from now on, even if you are on Darcula or a custom color scheme.
From version 2.9.0 a new entry named Directories has been added to the page, allowing to set a custom color to directories only, thus differentiating from regular files.
This setting depends on the Project View Settings’s Styled Directories and is disabled by default.
Note: Even though all customization options are available, only a portion of them is actually working. These are
Error Stripe Mark,
Underwaved. The rest won’t work.
If you’re a color scheme designer and want to make use of this feature for your color scheme, please insert those keys
.xml file (after replacing the values). Note that if you already defined colors when the IDE
feature was still working, it will work again when using the plugin.
<colors> <option name="FILESTATUS_ADDED" value="C3E88D"/> <option name="FILESTATUS_COPIED" value="C3E88D"/> <option name="FILESTATUS_DELETED" value="808080"/> <option name="FILESTATUS_HIJACKED" value="ffcb6b"/> <option name="FILESTATUS_IDEA_FILESTATUS_DELETED_FROM_FILE_SYSTEM" value="808080"/> <option name="FILESTATUS_IDEA_FILESTATUS_IGNORED" value="ab7967"/> <option name="FILESTATUS_IDEA_SVN_FILESTATUS_EXTERNAL" value="c3e88d"/> <option name="FILESTATUS_IGNORE.PROJECT_VIEW.IGNORED" value="ab7967"/> <option name="FILESTATUS_MERGED" value="C792EA"/> <option name="FILESTATUS_MODIFIED" value="80cbc4"/> <!--<option name="FILESTATUS_NOT_CHANGED" value="626669"/>--> <option name="FILESTATUS_NOT_CHANGED_IMMEDIATE" value="80cbc4"/> <option name="FILESTATUS_NOT_CHANGED_RECURSIVE" value="80cbc4"/> <option name="FILESTATUS_SWITCHED" value="C792EA"/> <option name="FILESTATUS_SUPPRESSED" value="979FAD"/> <option name="FILESTATUS_UNKNOWN" value="f77669"/> <option name="FILESTATUS_addedOutside" value="C3E88D"/> <option name="FILESTATUS_changelistConflict" value="d5756c"/> <option name="FILESTATUS_modifiedOutside" value="82AAFF"/> </colors>
Because this feature modifies the original
VCS File Colors feature, please bear in mind the following issues:
- When switching to other scheme that do not define file status colors, some defaults will be applied which are not the defaults provided by Darcula/IntelliJ, and therefore look bad.
- Uninstalling/Disabling the plugin will not revert back these settings, so you will still keep the last file colors even after restarting.
Thankfully there is an easy fix for that: in the
VCS File Colors there is a button Reset Default that will revert
the value back to the Darcula/IntelliJ default. Note however that as soon as you change a color scheme the values will
change back again.