Here's the short version:
.sublime-theme
files change the look of the UI including the Sidebar and File Tabs.
- 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:
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:
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.