The Launcher Themes feature allows you to personalize the appearance of your Electron Launcher and host your custom theme on PatchKit servers. You can modify the background, icons, fonts, colors, and more to create a unique user experience.

Creating a Theme

To create a custom theme, follow the detailed instructions provided on the Customizing Launcher page, specifically under the Electron-Based Launcher section.

Uploading a Theme

1. Visit the PatchKit Dashboard and sign in.
2. In the left sidebar, click on the Launcher Themes link.
3. Press the New Launcher Theme button.
4. Click the New Version button.
5. Choose the theme file (.zip format) and click the Upload button (you can ignore the Launcher Version field for now).

Understanding the Launcher Version Field

The Launcher Version field is used to indicate the launcher version compatible with the theme. If left empty, it will default to the highest defined version or 0.0.0 (compatible with all). If a launcher version is specified, the theme will only be compatible with that specific version and newer versions sharing the same major version number.

For example, if you specify 1.0.0 as the launcher version, the theme will be compatible with launcher versions 1.0.0, 1.0.1, 1.0.2, 1.1.0, 1.1.1, 1.2.0, 1.2.1, and so on, but not with launcher versions 2.0.0, 2.0.1, 2.1.0, 2.1.1, etc.

On the launcher version page, you can find all launcher versions sorted by their release date. The most recent version is at the top. If multiple versions have the same version number, the one with the latest release date takes precedence and will be used by the launcher.

Implementing a Theme

A newly uploaded theme is not immediately available to users. To make it accessible, you must associate it with a specific launcher app. You can do this from the Launcher Themes page in the PatchKit Dashboard or through your launcher app settings.

Associating a Theme from the Launcher Themes Page

1. Visit the PatchKit Dashboard and sign in.
2. In the left sidebar, click on the Launcher Themes link.
3. Press the Edit button next to the theme you want to associate.
4. Click the Assign to Launcher button.
5. Choose the launcher app you want to associate the theme with, and click the Assign button.

Associating a Theme from Launcher App Settings

1. Visit the PatchKit Dashboard and sign in.
2. In the left sidebar, click on the Applications link.
3. Select the name of the launcher app you want to associate the theme with.
4. From the Launcher Theme list, choose the theme you want to associate and click the Save button.

Now, your users can access the theme you’ve uploaded. The launcher may need to be restarted for the changes to take effect.

FAQ

How to remove a theme?

To remove a theme, you must first unbind it from all launcher apps. You can do this from the Launcher Themes page in the PatchKit Dashboard by clicking the Unassign button, or from your launcher app settings by selecting the (default) launcher theme.

How do I revert to a previous version of a theme?

To revert to a previous version of a theme, you must delete all newer versions of the theme. You can do this from the Launcher Themes page in the PatchKit Dashboard by clicking the Delete button next to the version you want to remove.

How do I completely remove a theme?

To completely remove a theme, access the Launcher Themes page in the PatchKit Dashboard, click the Edit button next to the theme you want to remove, then click on the cogs dropdown and select the Delete button.