Themes

From Mumble Wiki
Revision as of 10:11, 12 July 2015 by Kissaki0 (talk | contribs) (add category)
Jump to: navigation, search

What is a theme?

Mumble 1.3 introduced the concept of themes to allow adjusting the look and feel of the Mumble client. This includes icons, fonts, colors and more. By default Mumble ships with its own theme with two possible styles called "Lite" and "Dark".

Selecting a theme

A theme can be selected in the "User Interface" section of the Mumble configuration. You can reach it via Configure->Settings and then selecting "User Interface". There use the "Theme" drop down to select the specific style and theme you want to use.

Mumble theme selection drop-down

Press "Ok" and accept the request to restart Mumble.

Installing a new theme

You should always refer to installation instructions that the theme author has provided with the theme. If there are no instructions included with the theme or found on the website you downloaded it from, the most common installation process would be to extract the theme into a new directory in your Mumble's theme directory at:

C:\Users\<YOURUSERNAME>\AppData\Roaming\Mumble\Themes\

You can make sure that you extracted theme correctly by checking for the "theme.ini" file which should be located at:

C:\Users\<YOURUSERNAME>\AppData\Roaming\Mumble\Themes\<Name of the new Theme>\theme.ini

If you ever have trouble getting a theme to work properly, you should contact the theme's author about it and not the Mumble community. Keep in mind some themes may be outdated and may not work properly on the latest version of Mumble.

Using old skins as themes

Themes are mostly comparable and compatible with the Skins from 1.2.X, but are more convenient to use and more powerful. If you have an existing Mumble 1.2.X you would like to keep using simply place it in its own folder in the Themes directory and make sure the theme's qss file is in that directory. Mumble will pick it up with the name of the theme being set to the directory name and each qss file in the directory being interpreted as a specific style of the theme.

Creating a theme

A theme consist of a qss file, resources and a theme.ini file describing the theme and its styles. See the Skinning page on how to create the .qss file. For the corresponding theme.ini take a look at the Mumble theme's theme.ini