Customise Interface Colours
Select a theme to set an overall colour tone. Read about themes at:
https://github.com/eliranwong/UniqueBible/wiki/Themes
Further Colour Customisation is possible, in addition to theme selection.
Colour appearance of Material menu layout icons are controlled by the following configuration values.
widgetBackgroundColor - Widget background color in 'material' menu layout.
widgetForegroundColor - Widget foreground color in 'material' menu layout.
widgetBackgroundColorHover - Widget background color when a widget is hovered in 'material' menu layout.
widgetForegroundColorHover - Widget foreground color when a widget is hovered in 'material' menu layout.
widgetBackgroundColorPressed - Widget background color when a widget is pressed in 'material' menu layout.
widgetForegroundColorPressed - Widget foreground color when a widget is pressed in 'material' menu layout.
maskMaterialIconBackground - config.maskMaterialIconColor applies to either background or foreground of material icons. Set it to True to apply the mask to background. Set it to False to apply the mask to foreground.
maskMaterialIconBackground - Use this color for masking material icons.
lightThemeTextColor / darkThemeTextColor - Text colour displayed on dark / light theme.
lightThemeActiveVerseColor / darkThemeActiveVerseColor - Active verse colour displayed on dark / light theme.
textSelectionColour - Colour for text selection
You can edit the configuration values manually.
Customization is loaded either in config.py file or custom configurations in /plugin/config directory.
-
Exit UBA first, and make sure UBA is not running when you edit configuration values.
-
Use a text editor to edit values in files in the directory /plugins/config. If color customization files do not exist in /plugins/config, then edit the config.py file.
materialIconMaskColor = 'red'
maskBackground = False
pushButtonBackgroundColor = 'black'
pushButtonForegroundColor = 'red'
- Start UBA and you should see the values above give you the following result.
Even you can edit config.py manually, we recommend you to use GUI dialog instead.
- To open the GUI dialog for colour customisation, open from menu: UniqueBible > Appearance > Customise Colour
- Click on button on the left column to start editing individual values.
- With Colour Picker dialog, you can either manually enter a value or use a mouse click to select a colour or pick a screen colour.
You may check colour codes at https://htmlcolorcodes.com/color-names/ if you want do manual entries.
With "Export" and "Import" buttons, you can save a copy or different copies of your own colour choices and load it as you want.
For demonstration purpose, we provide two colour customisation sample files, "sample.color" and "sample2.color". You can find them in UBA home directory, UniqueBible/.
Click "Load my settings" and select "sample.color" or "sample2.color", and you will see the changes as below:
Load "sample.color" to get the following result:
Load "sample2.color" to get the following result:
If anything goes wrong, you can always go back to the default colours by clicking the "Default" button, as indicated below:
