Description · Installation · Programs

List of all templates

• Hyprland
• Hyprlock
• Waybar
• Kitty
• GTK (3.0, 4.0)
• Sway
• Wlogout
• Rofi
• Dunst
• Qt (qt5, qt6)
• Qt-Method-2(qt5, qt6)
• Alacritty
• Starship
• Midnight Discord
• Pywalfox
• Yazi
• Zathura
• Fuzzel
• Television
• Cava
• Helix
• Btop

Hyprland

Copy the hyprland-colors.conf template and add it to the matugen config.

[config]
# ...

[templates.hyprland]
input_path = 'path/to/template'
output_path = '~/.config/hypr/colors.conf'
post_hook = 'hyprctl reload'

Then, add this line to the top of your ~/.config/hypr/hyprland.conf file

source = colors.conf

The theme will now be applied after you reload hyprland.

Note

To reload hyprland you can either quit the current session and enter it again, or you can run hyprctl reload which instantly reloads your config.

Hyprlock

Hyprlock uses the same color format as Hyprland so we can use hyprland-colors.css, if you didn't make the template above, Copy the hyprland-colors.conf template and add it to the matugen config.

[config]
# ...

[templates.hyprland]
input_path = 'path/to/template'
output_path = '~/.config/hypr/colors.conf'

Then, add this line to the top of your ~/.config/hypr/hyprlock.conf file

source = colors.conf

Configuration Example (hyprlock.conf):

source = colors.conf
background {
    path = $image  # This variable contains the image you selected with matugen     
}

label {
    color = $primary
}

Waybar

Copy the colors.css template and add it to the matugen config.

[config]
# ...

[templates.waybar]
input_path = 'path/to/template'
output_path = '~/.config/waybar/colors.css'
post_hook = 'pkill -SIGUSR2 waybar'

Then, add this line to the top of your ~/.config/waybar/style.css file

@import "colors.css";

You can now use all the color variables inside the file.

* {
     background-color: @primary_container;
}

Kitty

Copy the kitty-colors.conf template and add it to the matugen config.

[config]
# ...

[templates.kitty]
input_path = 'path/to/template'
output_path = '~/.config/kitty/colors.conf'
post_hook = 'pkill -SIGUSR1 kitty'

Then, add this line to the bottom of your ~/.config/kitty/kitty.conf

include colors.conf

The theme will now be applied after you reload kitty.

To reload all the kitty instances automatically you can use kitty's own built-in theme manager through a kitten. To accomplish this we need to set the output_path of [templates.kitty] to ~/.config/kitty/theme/your-theme.conf

Then append [templates.kitty] with

post_hook = "kitty +kitten themes --reload-in=all your-theme"

Kitty Themes Wiki

GTK

[config]
# ...

[templates.gtk3]
input_path = 'path/to/template'
output_path = '~/.config/gtk-3.0/colors.css'
post_hook = 'gsettings set org.gnome.desktop.interface gtk-theme ""; gsettings set org.gnome.desktop.interface gtk-theme adw-gtk3-{{mode}}'

[templates.gtk4]
input_path = 'path/to/template'
output_path = '~/.config/gtk-4.0/colors.css'

Then, add this line to the top of your ~/.config/gtk-3.0/gtk.css and ~/.config/gtk-4.0/gtk.css

@import 'colors.css';

Sway

[config]
# ...

[templates.sway]
input_path = 'path/to/template'
output_path = '~/.config/sway/colors.conf'
post_hook = 'swaymsg reload'

Then, add this line to your ~/.config/sway/config

include colors.conf

wlogout

[config]
# ...

[templates.wlogout]
input_path = 'path/to/template'
output_path = '~/.config/wlogout/colors.css'

Then, add this line to the top of your ~/.config/wlogout/style.css

@import "colors.css";

You can now use all the color variables inside the file.

* {
     background-color: @primary_container;
}

Rofi

[config]

[templates.rofi]
input_path = 'path/to/template'
output_path = '~/.config/rofi/colors.rasi'

Then, add this line to the top of your ~/.config/rofi/config.rasi

@import "colors.rasi"

You can now use all the color variables inside of the config.rasi.

* {
     background-color: @primary-container;
}

dunst

[config]

[templates.dunst]
input_path = 'path/to/template'
output_path = '~/.config/dunst/dunstrc'
post_hook = 'pkill -SIGUSR2 dunst

qt

Change 5 to 6 for qt6ct

[config]

[templates.qt5ct]
input_path = 'path/to/template'
output_path = '~/.config/qt5ct/colors/matugen.conf'

Then, add these two lines to the top of your ~/.config/qt5ct/qt5ct.conf

[Appearance]
color_scheme_path=yourusername/.config/qt5ct/colors/matugen.conf
custom_palette=true

Qt-Method-2

Note: the output path needs to be ~/.local/share/color-schemes/ in order for qt*ct to be able to find the color sheme

[templates.color-scheme]
input_path = '~/.config/matugen/templates/Matugen.colors'
output_path = '~/.local/share/color-schemes/Matugen.colors'

Then, add these four lines to the top of ~/.config/qt5ct/qt5ct.conf and do the same for qt6

color_scheme_path=~/.local/share/color-schemes/Matugen.colors
custom_palette=true
icon_theme=breeze
style=Breeze

Finally, make sure you have this environment variable QT_QPA_PLATFORMTHEME set to qt6ct.

Note

for the theme to work you need to install the following
Arch Linux (AUR):

• yay -S breeze breeze5 breeze-icons breeze-gtk qt6ct-kde qt5ct-kde
  

Alacritty

[config]

[templates.alacritty]
input_path = 'path/to/template'
output_path = '~/.config/alacritty/colors.toml'

Then, add this line to your ~/.config/alacritty/alacritty.toml

import = ["colors.toml"]

Starship

[config]

[templates.starship]
input_path = 'path/to/template'
output_path = '~/.config/starship.toml'

Midnight Discord

Copy the midnight-discord.css template and add it to the matugen config.

[config]

[templates.vesktop]
input_path = 'path/to/template'
output_path = '~/.config/vesktop/themes/midnight-discord.css'

Note

output_path may be different if you are using Flatpak version of Vesktop.

Then, activate the theme from vencord themes.

Pywalfox

[config]

[templates.pywalfox]
input_path = 'path/to/template'
output_path = '~/.cache/wal/colors.json'
post_hook = 'pywalfox update'

Note

Add the Pywalfox plugin to firefox / thunderbird.
Dependencies: pywalfox
Install:

• Arch (AUR): yay -S python-pywalfox
• GNU/Linux, MacOS, Windows: Follow Instructions

That's it!

Yazi

[config]

[templates.yazi]
input_path = 'path/to/template'
output_path = '~/.config/yazi/theme.toml'

Zathura

[config]

[templates.zathura]
input_path = 'path/to/template'
output_path = '~/.config/zathura/zathurarc'

Then, if transparency is needed just change the alpha value in:

set default-bg              "{{colors.on_primary.default.rgba | set_alpha: 1.0}}"
set recolor-lightcolor      "{{colors.on_primary.default.rgba | set_alpha: 1.0}}"

And to change the font family and size just write it to:

set font "FiraCode Nerd Font 12"

Fuzzel

[config]

[templates.fuzzel]
input_path = 'path/to/template'
output_path = '~/.config/fuzzel/colors.ini'

Then, add this line to the top of your ~/.config/fuzzel/fuzzel.ini file

[main]
include = "~/.config/fuzzel/colors.ini"

Television

[config]

[templates.television]
input_path = 'templates/television.toml'
output_path = '~/.config/television/themes/matugen.toml'

Then, add this line to the ui section of your ~/.config/television/config.toml file

[ui]
theme = "matugen"

Cava

Copy the cava-colors.ini template and add it to the matugen config.

[config]
# ...

[templates.cava]
input_path = '~/.config/matugen/templates/cava-colors.ini'
output_path = '~/.config/cava/themes/your-theme'
post_hook = "pkill -USR1 cava"

Update the theme variable theme = 'none' in the cava configuration file ~/.config/cava/config with the output_path filename.

theme = 'your-theme'

And that's it, by default the vertical gradient effect is activated, to disable it comment the line gradient = 1 and uncomment ; gradient = 0 inside the cava-colors.ini template.

Note

Cava's current support for loading themes externally is only available in the git version, you will have to compile from source for it to work.

Helix

[templates.helix]
input_path = 'path/to/template'
output_path = '~/.config/helix/themes/matugen.toml'

Then, add this line to your ~/.config/helix/config.toml

theme = "matugen"

Btop

[config]

[templates.btop]
input_path = 'path/to/template'
output_path = '~/.config/btop/themes/matugen.theme'

Then Choose matugen theme from btop settings.

Acknowledgements

Heus-Sueh