Here's the short version:
.sublime-theme
files change the look of the UI including the Sidebar and File Tabs. 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.
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:
There are 2 different sections of Sublime that can be customized:
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)
Themes (highlighted in green)
.sublime-theme
files change the Theme, or the UI aspects of Sublime.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
).
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:
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.