Lib.rs

› Command line utilities
#color-palette #material-design #color-scheme #color-string #template #generation

bin+lib matugen

A material you color generation tool with templates

by InioX and 19 contributors

21 releases (10 stable)

2.4.1 Nov 13, 2024
2.3.0 May 30, 2024
2.2.0 Mar 26, 2024
1.2.1 Dec 25, 2023
0.8.2 Jun 2, 2023

#222 in Command line utilities

Download history 7/week @ 2024-08-22 14/week @ 2024-08-29 5/week @ 2024-09-05 17/week @ 2024-09-12 53/week @ 2024-09-19 31/week @ 2024-09-26 19/week @ 2024-10-03 25/week @ 2024-10-10 18/week @ 2024-10-17 9/week @ 2024-10-24 145/week @ 2024-10-31 137/week @ 2024-11-07 83/week @ 2024-11-14 13/week @ 2024-11-21 13/week @ 2024-11-28 287/week @ 2024-12-05

479 downloads per month

GPL-2.0 license

1.5MB
1.5K SLoC

A cross-platform material you color generation tool

Description

Features

  • Generate/Export Material You Color Palette:
    • Generate a Material You color palette either from an image or a color
    • Output the generated palette as JSON to stdout, or use keywords inside templates that get exported as files
  • Keyword Filters:
    • Use filters to change values of the keywords, like changing lightness for colors and manipulating strings with replace, to_upper, to_lower and set_lightness
  • Custom Keywords/Colors:
    • Define your own custom keywords or colors you would like to be harmonized inside the config file, that you can then use in templates
  • Palette Customization:
    • Customize the contrast and scheme type for the palette
  • Restart Apps/Change Wallpaper:
    • Restart supported apps and set the wallpaper on Windows, MacOS, Linux and NetBSD

If you would like to learn more about the features and configuration, read the wiki here.

Other projects

  • Mitsugen - For gnome-shell, based on the old version of Matugen
  • pywal - More color generation backends, default theme files.
  • wpgtk - Like pywal, but with a gui and more features.

Supported platforms

  • Windows
  • Linux
  • MacOS
  • NetBSD

Installation

Cargo Cargo Version

Click to expand 
cargo install matugen

Arch AUR Version

Click to expand

Using your favourite AUR helper:

yay -S matugen-bin

NixOS nixpkgs NixOS Version

Click to expand

Add matugen to your flake inputs:

inputs = {
  matugen = {
    url = "github:/InioX/Matugen";
    # If you need a specific version:
    ref = "refs/tags/matugen-v0.10.0"
  };
  # ...
};

Then you can add it to your packages:

let
  system = "x86_64-linux";
in {
  environment.systemPackages = with pkgs; [    
    # ...
    inputs.matugen.packages.${system}.default
  ];
}

This flake also provides a NixOS/Home Manager module, which can be imported by adding this in your configuration:

{pkgs, inputs, ...}: {
  imports = [
    inputs.matugen.nixosModules.default
  ];

  # ...
}

The module does NOT automatically symlink the files. For an example of using this module with Home Manager, see https://github.com/InioX/matugen/issues/28

Option details can be found by reading the module. A search.nixos.org-like option viewer is planned.

NetBSD pkgsrc current package

Click to expand 
pkgin install matugen

or, if you prefer to build it from source

cd /usr/pkgsrc/graphics/matugen
make install

Themes

Templates

Acknowledgements

Dependencies

~15–32MB
~434K SLoC