Everything described here is subject to change. It could be possible that a new version will introduce new features or major changes to the stylesheet!
Therefore UGXL is using the Qt Stylesheets (http://doc.qt.io/qt-5/stylesheet.html) for themeing.
All themes are stored at
The applications needs to be restarted to recognize newly added themes.
Creating a custom theme
Create a new folder within the theme folder.
Be sure that your theme folder name is unique!
Create (or copy from the default theme) the theme.ugxl file
This file stores a couple of inormation like creator, version info and special settings.
(theme.ugxl of the default theme)
The format of that file is JSON (www.json.org)
The preview.png (optional) will be displayed in the Settings.
The dimensons of that image are 210x127 (WxH).
You can create subfolders to keep your theme folder clear.
Currently UGL is using one Qt Stylesheet, located at
http://sourceforge.net/projects/qsseditor/ the QSS Editor can help you to create most of the controls in realtime already.
But this won't work for special UGX Launcher features. Theme variables won't work either!
Qt Stylesheet Documentation
- Syntax http://doc.qt.io/qt-5/stylesheet-syntax.html
- Reference http://doc.qt.io/qt-5/stylesheet-reference.html
- Examples http://doc.qt.io/qt-5/stylesheet-examples.html
|%UGXL%||Path to the root directory of UGXL|
UGXL has a special designer mode, which helps during the implementation process.
To enable the Designer Mode, simply create a shortcut to the UGX Launcher.exe and use the -des command argument.
- Alexander Diller add screenshots + more information how it works
You can load custom fonts into UGXL.
Simply drop the .ttf or .otf font into <theme_root>/fonts and it can be used like any other font for styling.
Custom Controls Documentation
UGX Launcher has a couple of custom controls which can be customized within main.qss
Windows are using a method called 9-Grid.
More will follow
Share and submit your theme