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](https://github.com/DimitrisMilonopoulos/mitsugen) - For gnome-shell, based on the [old](https://github.com/InioX/matugen/tree/python) version of Matugen
- [pywal](https://github.com/dylanaraps/pywal) - More color generation backends, default theme files.
- [wpgtk](https://github.com/deviantfero/wpgtk) - Like pywal, but with a gui and more features.
Supported platforms
- Windows
- Linux
- MacOS
- NetBSD
Installation
Cargo
Click to expand
```shell
cargo install matugen
```
Arch
Click to expand
Using your favourite AUR helper:
```shell
yay -S matugen-bin
```
NixOS
Click to expand
Add matugen to your flake inputs:
```nix
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:
```nix
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:
```nix
{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](./module.nix). A
[search.nixos.org](https://search.nixos.org/options)-like option viewer is
planned.
NetBSD
Click to expand
```shell
pkgin install matugen
```
or, if you prefer to build it from source
```shell
cd /usr/pkgsrc/graphics/matugen
make install
```
Themes
#### Templates
- [InioX/matugen-themes](https://github.com/InioX/matugen-themes)
Acknowledgements
- [material-colors](https://github.com/Aiving/material-colors)
- [wallpaper.rs](https://github.com/reujab/wallpaper.rs) - Changing wallpaper for Windows