Welcome to the Documentation for the Themer Plugin

Some things may apply to the XPosed Module too

DIRECTLY MODIFY THE JSON FILE AT YOUR OWN RISK

• Start by making a new Theme inside of the Themer plugin settings, give it a name and it will set Version, and Author (you) automatically for you.
• You will see multiple categories, choose the simple colors category and click on the + icon to add a new string. Add a background string and give it some color by clicking on it.
• Save, then select restart to see how it looks!

Strings used for the plugin to tell the user what the name of the Theme is, Author, Version, License, etc but also things like custom font and custom background

Used to show name of the theme, author, etc. They are in the "manifest" section of the .json

{
  "name": "the theme name",
  "author": "authors name",
  "license": "license, ask if you want to add one but dont know how to or what license to choose in #theme-development",
  "version": "this is the verion number, do not use text for updater",
  "updater": "this is where you put your raw.githubusercontent.com link, if you ever want to update your theme just bump the version number up"
}

If done correctly it should look similar to this in the .JSON

These are the strings for adding a background and also giving it transparency (alpha). They are in the "background" section of the .json

Warning: Your Background won't be visible unless you enable transparency!

{
  "url": "url for the bg image",
  "overlay_alpha": "background transparency, goes from 0 to 255, 0 being fully transparent while 255 being fully opaque",
  "blur_radius": "background blur, goes from 0 to 25, 0 being no blur and 25 a lot of blur. yep I cant tell you better"
}

If done correctly it should look similar to this in the .JSON

The string for the font URL. The string is in the "fonts" section of the .json.

{
  "*": "This changes the font globally",
  "ginto_bold": "changes categories, channel names, and headers in user settings",
  "ginto_medium": "changes user settings category names, and the channel name in the member list",
  "ginto_regular": "changes nothing for me, you can test it if you want",
  "roboto_medium_numbers": "changes nothing for me, you can test it if you want",
  "sourcecodepro_semibold": "changes nothing for me, you can test it if you want",
  "whitney_bold": "changes server template names, and Invite should look like this",
  "whitney_medium": "changes message text, channel names, button names, etc",
  "whitney_semibold": "changes selected channel name, DM List names, etc"
}

If done correctly it should look similar to this in the .JSON

Only the links listed below are accepted for external resources. Other links will refuse to load. This is for security and privacy reasons.

Note: Due to discord having their cdn require authentication, using cdn.discordapp.com and media.discordapp.net links will no longer work.

• github.com
• raw.githubusercontent.com
• gitlab.com
• i.imgur.com
• i.ibb.co

These are provided by the plugin (or Xposed module). They theme many things at once for convenience.

Normal strings will take priority over simple strings!

If you'd like to know what groups of strings are changed by the strings shown above view this.

Accent strings are used mostly for brand colors.

Primary dark strings are used for main elements of discord, such as buttons, text and backgrounds.

General Strings are used mostly used for smaller things, such as toasts and other text colors.

UIKit strings are used for brand colors that aren't blurple, along with text and buttons.

Drawable strings are icons / images you see throughout discord.

Themes the channel icon found at the top bar next to the channel name.

Themes the connection icons found under user's about me.

Material You is a new project by Google that tries to unify android themeing and make one global style that applies to all apps. It was added in Android 12, so you will need Android 12. Learn more

The themer plugin has support for it, allowing you to make themes that adapt to your system.

This requires directly modifying the JSON file, so you will have to familiarise yourself with JSON.

You are advised to install this app, which will allow you to see all colors generated by Material You.

Open the Themer plugin menu and create a theme. This creates the JSON file that you will use for adding Material You values. In the Themer plugin add random colors to all the UI elements you'd like to change (this saves time later in the process).

Now that you have that, open the JSON file in your preferred text editor then move on to the next section.

• Vscode (Desktop)
• MiXplorer Editor (Mobile)

Material You colors are separated into 5 groups:

• accent1
• accent2
• accent3
• neutral1
• neutral2

This is where the app comes into play. Launch it and you will see all 5 groups and different numbers inside of those groups which are different shades of that group.

Every Material You color consists of a few components: system_ + group + _ + shade, so for example system_accent1_300

Using the app, find colors you like, figure out the full name as described above and replace the number (something like -292992) with the string. Note: Strings are wrapped into double quotes, so your theme should end up looking something like this:

{
    "colors": {
        "some-color": "system_accent0_300"
    } 
}

More detailed explanation can be found here.

Download Example Theme

• This link by Ven might help you if you know what you're doing.

https://gist.github.com/Vendicated/7e8aa7b2512b8e38e041692cbf34acfa

• As Riyu has found out, a lot of things in Light mode are not themable, but ven did say he will add more light mode support. Link to Riyu's light mode tests

Due to Android's updates, specific elements in any/all themes might not be colored anymore depending on the device. Some of the important ones: chatbox input background, active dm button background, channel colors (the icons still work) etc. Not to worry, unless you're on Android 12+, they will work for you. Otherwise, it really depends what the device is, but it can happen.

• Background color not changing

Unfortunately sometimes this depends on your ROM

• Background image not changing

Please check that you've used an allowed link and have transparency enabled (don't use cdn)