fuzzel
Generates a colour-only INI theme for Fuzzel, the lightweight Wayland application launcher. The output is a single [colors] section using fuzzel's RRGGBBAA (hex without #) format, suitable for include= from your main fuzzel.ini or for use standalone with fuzzel --config.
Installation
Built into tinct — nothing to install separately. tinct generate -o fuzzel works out of the box.
Quick start
tinct generate -i image -p ~/Pictures/wallpaper.jpg -o fuzzel
Generated files
| File | Path | Role |
|---|---|---|
tinct.ini | ~/.config/fuzzel/themes/tinct.ini | A [colors] section with every fuzzel colour key in RRGGBBAA hex format. Drop it in via include= or pass it to fuzzel --config. |
Generated format
# Fuzzel theme generated by tinct
[colors]
background=1e1e2eff
text=cdd6f4ff
match=89b4faff
selection=313244ff
selection-text=cdd6f4ff
selection-match=89b4faff
border=89b4faff
Integration
Fuzzel supports include= directives. Add one line to your ~/.config/fuzzel/fuzzel.ini:
include=~/.config/fuzzel/themes/tinct.ini
Keep your structural settings (font, layout, prompt, terminal) in fuzzel.ini and let the included file own the [colors] block.
Alternatively, run fuzzel with the file as a standalone config:
fuzzel --config ~/.config/fuzzel/themes/tinct.ini
This is useful for one-off use or for binding a themed launcher to a specific keybind without touching your global fuzzel.ini.
Reload behaviour
Automatic
None. Fuzzel reads its config on every launch — there's no daemon to reload.
Manual fallback
Close any open fuzzel window and launch a new one. The next invocation picks up the new colours automatically.
Uninstall / revert
-
Remove the include line from your
~/.config/fuzzel/fuzzel.ini:sed -i '/themes\/tinct\.ini/d' ~/.config/fuzzel/fuzzel.ini -
Delete the generated file:
rm ~/.config/fuzzel/themes/tinct.ini -
Reload to drop the theme: no action needed. The next fuzzel invocation uses your previous styling.
-
External state: this plugin only writes to
~/.config/fuzzel/themes/. No further cleanup is required.
Flags
| Flag | Default | Description |
|---|---|---|
--fuzzel.output-dir | ~/.config/fuzzel/themes | Override the output directory |
Colour role mapping
All values are emitted in fuzzel's RRGGBBAA (hex without #) format.
Fuzzel key ([colors]) | Tinct role | Notes |
|---|---|---|
background | background | 85% opacity to let the compositor blur the wallpaper through. |
text | foreground | Unselected entry text. |
prompt | accent1 | Prompt character(s). |
placeholder | foregroundMuted | 80% opacity. |
input | foreground | Current input text. |
match | accent2 | Matched substring within an entry. |
selection | accent1 | Selected entry background. |
selection-text | onAccent1 | Selected entry text. |
selection-match | accent2 | Matched substring within the selected entry. |
counter | info | "N/M results" counter. |
border | accent1 | Launcher window border. |
Customising the template
Extract the default template to override it:
tinct plugins templates dump -o fuzzel -l ~/.config/tinct/templates/fuzzel
This creates ~/.config/tinct/templates/fuzzel/tinct.ini.tmpl. Tinct uses your version in preference to the embedded default.
See the templating reference for the available functions and palette accessors.
Troubleshooting
Colours didn't change
Fuzzel reads its config when it launches; if you have a session open it's still using the old config. Close it and re-invoke. If the new launch is still old colours, your fuzzel.ini has explicit [colors] entries that override the included file — fuzzel processes the main file last, so its values win. Move those overrides out of fuzzel.ini, or after the include= line.
fuzzel: command not found
The plugin lists fuzzel as a required binary. Install it via your distro's package manager (pacman -S fuzzel, apt install fuzzel, etc.) or build from the upstream repository.
unknown key: selection-match
Older fuzzel versions don't recognise every key the template emits. Upgrade to fuzzel 1.10+ for full coverage, or extract the template and drop the unsupported lines.