Description · Installation · Programs

List of all templates

• Hyprland
• Hyprlock
• Waybar
• Kitty
• GTK (3.0, 4.0)
• Sway
• Wlogout
• Rofi
• Dunst
• Qt (qt5, qt6)
• Alacritty
• Starship
• Midnight-Discord
• Pywalfox

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'

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.

GTK

[config]
# ...

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

[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'

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

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'

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!

Acknowledgements

Heus-Sueh