matugen-themes

The matugen-themes repository provides a collection of templates designed to work with matugen to generate dynamic color schemes for various websites and programs. The themes are categorized into:

• Websites: CSS templates for platforms like YouTube, Bitwarden, and GitHub.
• Programs: Configuration templates for applications like Aerc and Alacritty.

Users can use these templates to apply consistent, color-matched themes across their web browsing and terminal environments.

Lualine uses its own highlight groups that base16-colorscheme cannot style automatically. To integrate them, set the Lualine theme to "base16".

Important: Lualine must be re-sourced every time Matugen updates to refresh its colors. To do this, add require('lualine').setup({}) to the end of your Matugen template.lua. For cleaner configurations, refactor your Lualine setup into a separate file and use dofile() in both your init.lua and the Matugen template.

require('lualine').setup({
  options = {
    theme = "base16",
  }
})

Since Neovim doesn't support hot-reloading natively, you can register a Signal autocmd to listen for SIGUSR1. When the signal is received, execute a callback that re-sources the Matugen file and re-initializes plugins like Lualine.

Note: This implementation is tested for Linux.

-- Register an autocmd to listen for matugen updates
vim.api.nvim_create_autocmd("Signal", {
  pattern = "SIGUSR1",
  callback = auxiliary_function,
})

-- Main entrypoint on matugen reloads
local function auxiliary_function()
  -- 1. Load the matugen style file
  source_matugen()

  -- 2. Re-source Lualine (since base16 reload overwrites it)
  dofile(os.getenv("HOME") .. '/.config/nvim/config/plugins/lualine-nvim.lua')

  -- 3. Apply any other manual tweaks
  vim.api.nvim_set_hl(0, "Comment", { italic = true })
end

To apply Matugen colors to the Spicetify Sleek theme:

1. Create a new template file using the content from ./templates/spicetify.ini.
2. Configure the template in Matugen. Note the post_hook to automatically apply the theme:

[config]
# ...
[templates.spotify]
input_path = 'path/to/template'
output_path = '~/.config/spicetify/Themes/Sleek/color.ini'
post_hook = 'pgrep -x spicetify > /dev/null || spicetify apply -n'

3. Update your ~/.config/spicetify/config-xpui.ini:

color_scheme = matugen
current_theme = Sleek

To theme MangoWC, create a template file using content from ./templates/mango.conf. In config.toml, define [templates.mango] with the output path ~/.config/mango/colors.conf and use mmsg -d reload_config as the post_hook. Then, source the generated file in your MangoWC configuration.

MangoWC Configuration (~/.config/mango/config.conf):

source=~/.config/mango/colors.conf

[templates.mango]
input_path = 'path/to/template'
output_path = '~/.config/mango/colors.conf'
post_hook = 'mmsg -d reload_config'

The module installs templates to ~/.config/matugen/templates/. If you need to change the UI layout or how colors are applied, you must edit the template files directly:

• UI Layout: Edit ./templates/rmpc.ron to adjust the layout. Note that changing the layout may be required if the default provided does not suit your needs.
• Cava Colors: In this theme, cava is embedded in rmpc. While rmpc supports single, rows, and gradient color settings, horizontal_gradient is currently unsupported. Refer to the Cava/Theming documentation for more details on color application.

To use Matugen generated colors with Qt applications, configure a color-scheme template in your Matugen configuration.

1. Define the template in your Matugen config:

[config]
# ...
[templates.color-scheme]
input_path = '/path/to/template/'
output_path = '~/.local/share/color-schemes/Matugen.colors'

2. Update your ~/.config/qt5ct/qt5ct.conf and ~/.config/qt6ct/qt6ct.conf files by adding these lines to the top:

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

3. Ensure the environment variable QT_QPA_PLATFORMTHEME is set to qt6ct.

Dependencies (Arch Linux):

• For general setup: yay -S breeze-icons breeze-gtk qt6ct-kde qt5ct-kde
• For KDE style: pacman -S breeze breeze5
• For a cleaner style: yay -S darkly-bin

To theme PrismLauncher, create a template file from ./templates/prismlauncher.json. In config.toml, define [templates.prismlauncher] with the output path ~/.local/share/PrismLauncher/themes/Matugen/theme.json.

In PrismLauncher, go to Settings > Appearance and set the theme to Matugen.

[templates.prismlauncher]
input_path = '~/.config/matugen/templates/prismlauncher.json'
output_path = '~/.local/share/PrismLauncher/themes/Matugen/theme.json'

To theme OBS, create a template file from ./templates/matugen.obt. In config.toml, define [templates.obs] with the output path ~/.config/obs-studio/themes/matugen.obt.

After generation, open OBS and navigate to: File > Settings > Appearance > Theme > Matugen.

[templates.obs]
input_path = 'path/to/template'
output_path = '~/.config/obs-studio/themes/matugen.obt'

To use Matugen with Wofi, create a new template file using the content from templates/zellij-theme.kdl.tera as a base. Then, register the template in your config.toml by specifying the input_path (pointing to your new template file) and the output_path (where the generated CSS will be saved). Finally, import the generated CSS into your Wofi style configuration.

1. Create a template file with content from templates/zellij-theme.kdl.tera.
2. Add the following to config.toml:

[config]
# ...
[templates.wofi]
input_path = "/path/to/template"
output_path = "~/.config/wofi/colors.css"

3. Import the colors in ~/.config/wofi/style.css:

@import "colors.css";

You can style Neovim using standard .vim configuration. Create a template file from ./templates/nvim-colors.vim and define it in config.toml with the output path ~/.config/nvim/colors/matugen.vim and post_hook = 'pkill -SIGUSR1 nvim'.

For init.vim:

colorscheme matugen
autocmd Signal SIGUSR1 colorscheme matugen

For init.lua:

vim.cmd("colorscheme matugen")
vim.api.nvim_create_autocmd("Signal", {
    pattern = "SIGUSR1",
    command = "colorscheme matugen",
})

[templates.nvim]
input_path = 'path/to/template'
output_path = '~/.config/nvim/colors/matugen.vim'
post_hook = 'pkill -SIGUSR1 nvim'