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 resultRepeat 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.