[themes] Why do Sublime Text 3 Themes not affect the sidebar?

Here's the short version:

  1. .sublime-theme files change the look of the UI including the Sidebar and File Tabs.
  2. Defining these are a tremendous pain, so save yourself a lot of time and install the Theme Menu Switcher package.

Update: Sublime Text 3 has fundamentally changed the way Color Schemes and Themes work, and has broken many of the packages that were built to handle them. I can no longer confirm the accuracy of this post, nor the functionality of the packages mentioned herein because the Sublime developers have not fully explained the changes to the customization system nor addressed how to fix them. And, at the very best, they are far more difficult to change.

At this point, this post should only be used as a reference to the differences between "themes" and "color schemes" in Sublime Text 2, as I myself have yet to successfully change a theme nor color scheme in Sublime Text 3.

I will update this post as I can dedicate more time to unraveling this Sublime Customization Quagmire.


Here's the long version:

tmTheme vs sublime-theme file type affection areas Figure 1: The difference between "Color Schemes" and "Themes" - In the Sublime Community these terms are often confused and used interchangeably.

Changing the look of Sublime is a relatively difficult endeavor, for three main reasons:

  • Poorly chosen terminology
  • Misinformation in the Sublime Community
  • Installation Nightmare

Terminology

There are 2 different sections of Sublime that can be customized:

  • the editable region (the purple regions)
  • the User Interface (the green regions)

These use two different file types, and they do not accurately reflect the terminology.

The "Why?" of this decision is compatibility, and for brevity's sake I won't get into it here, but the fallout of this effort is:

The file type called tmTheme does not affect the theme, it affects the Color Scheme.

Color Schemes (highlighted in purple)

  • affect the look of the editable region (more specifically, the editable characters, ie what color they are when highlighted or not highlighted, etc).
  • relatively easy to produce
  • Color Schemes are Mistakenly called "Themes" all over the Sublime Community.

Themes (highlighted in green)

  • .sublime-theme files change the Theme, or the UI aspects of Sublime.
  • difficult to produce
  • It is difficult to find true Sublime Themes, compared to "Color Schemes"

Misinformation

Many packages claim to change the Theme, but actually change the Color Scheme. This is usually because the people producing them don't know that "Theme" specifically refers to the UI.

So another level of difficulty is finding a true "Theme" package, rather than Color Scheme.

Even some legit websites do not correctly make a distinction between the two, which adds to the challenges. For instance, colorsublime.com has a tutorial on changing the sublime "theme", but actually references the "Color Scheme" file type (.tmTheme).

Installation Pains

Themes and Color Schemes are hard to install and define. In fact, it's shocking how difficult the process is. The difficulty is further exacerbated with a fundamental change in installation and definition requirements in Sublime Text 3 that are not fully explained, which breaks many of the packages we once were reliant upon to change the Themes and Color Schemes.

It requires installing an actual Theme package (good luck finding one by browsing Packages in Package Control), defining it in settings, and then restarting Sublime. And, if you did something wrong, Sublime will simply replace your user-defined theme setting with the default. Yes, you heard me right, without notice or error message, Sublime will overwrite your theme definition.

But with Themes Menu Switcher All you need to do is go to Preferences > Theme and you'll see a list of all themes you have installed. You can also easily switch between themes without restarting Sublime.

Here's a sample from the website:Theme Switcher gif

I have no affiliation with Theme Menu Switcher at all, I'm just a fan.

Again, Theme Menu Switcher does not work the same in Sublime Text 3. If you need to have a customized look, I recommend not to update to Sublime Text 3.

Examples related to themes

Change the Theme in Jupyter Notebook? How to change the Spyder editor background to dark? How to edit default dark theme for Visual Studio Code? Why do Sublime Text 3 Themes not affect the sidebar? How do you set the title color for the new Toolbar? How to set editor theme in IntelliJ Idea How to change background color in the Notepad++ text editor? How to change app default theme to a different app theme? Apply a theme to an activity in Android? MySQL Workbench Dark Theme

Examples related to sublimetext

Sublime text 3. How to edit multiple lines? Why do Sublime Text 3 Themes not affect the sidebar? How to Install Sublime Text 3 using Homebrew 80-characters / right margin line in Sublime Text 3 Comparing the contents of two files in Sublime Text What is the default font of Sublime Text? Showing the same file in both columns of a Sublime Text window Sublime Text 3, convert spaces to tabs What is the difference between Sublime text and Github's Atom Sublime Text 2 multiple line edit

Examples related to sublimetext3

Sublime text 3. How to edit multiple lines? How to open remote files in sublime text 3 Eslint: How to disable "unexpected console statement" in Node.js? Why do Sublime Text 3 Themes not affect the sidebar? How to Install Sublime Text 3 using Homebrew How to change background and text colors in Sublime Text 3 80-characters / right margin line in Sublime Text 3 What is the default font of Sublime Text? Column/Vertical selection with Keyboard in SublimeText 3 How to compile and run C in sublime text 3? Why do Sublime Text 3 Themes not affect the sidebar? How to create a sticky left sidebar menu using bootstrap 3? Collapsing Sidebar with Bootstrap Force sidebar height 100% using CSS (with a sticky bottom image)?