Color Themes¶
Ulauncher comes with built-in color themes you can choose between. In addition to that you can install community contributed themes or create you own.
Installing Community Themes¶
If you find a community contributed theme you like, this is how you install it:
- Ensure that you have the user theme directory
mkdir -p ~/.config/ulauncher/user-themes
- Move to the user theme directory
cd ~/.config/ulauncher/user-themes
- Clone the theme
git clone git@github.com:<user_name>/<theme_name>.git
(replace with the actual user name and theme name) - Open Ulauncher Preferences and select the theme
Creating Custom Color Themes¶
You can only change colors in themes. Changing element sizes is not possible due to restrictions in the GTK+ API.
- Take a look at how the built-in themes are written
- Ensure that you have the user theme directory
mkdir -p ~/.config/ulauncher/user-themes
- Copy an existing theme directory to this directory.
- Rename the copied directory and change the name and display_name in
manifest.json
- Open Ulauncher Preferences and select your theme
- Edit colors in CSS files
- Tell Ulauncher to re-read theme files by running
kill -HUP <PID>
- Press
Ctrl+Space
(or your hotkey) to check the result - Repeat 6 - 8 until you get a desired result
You might find these two wiki entries on GTK+ CSS useful:
manifest.json¶
Use the following template:
{
"manifest_version": "1",
"name": "adwaita",
"display_name": "Adwaita",
"extend_theme": "light",
"css_file": "theme.css",
"css_file_gtk_3.20+": "theme-gtk-3.20.css",
"matched_text_hl_colors": {
"when_selected": "#99ccff",
"when_not_selected": "#99ccff"
}
}
manifest_version
- version ofmanifest.json
file. Current version is “1”name
- used to uniquely identify themedisplay_name
- is displayed in a list of theme options in preferencesextend_theme
- can benull
or a name of an existing theme you’d like to extendcss_file
- name of your css filecss_file_gtk_3.20+
- name css file for GTK+ v3.20 or highermatched_text_hl_colors
- Colors of characters in name or description of an item that match with your query. Must containwhen_selected
andwhen_not_selected
colors.
Note
All fields except extend_theme
are required and cannot be empty.