nix-rice

Bring ricing to Nix!

Nix-rice is a nix library compatible with both standard and flakes dependency systems. It provides a simple overlay to provide unified color scheme management for your packages

Why

Nix standard library does not have direct support for colors and their hexadecimal representation, commonly used in package configurations. This library tries to solve this by adding:

• Support to color definitions and transformations (RGBA and HSLA)
• Color serialization and deserialization as hexadecimal strings
• Color palette definitions and transformations
• Huge library of ready to use themes based on kovidgoyal's kitty-themes

Importing nix-rice in your configuration

Nix-rice supports both the standard derivation input system and the new flake system.

Nix-rice with default import system

1. Fetch the nix-rice using fetchGit as nix-rice
2. Either load the library: a. Import the library file using nix-rice-lib = import (nix-rice + "/lib.nix"); b. Access the library using using nix-rice-lib
3. Or load the overlay: a. Import the overlay file using nix-rice-overlay = import (nix-rice + "/overlay.nix"); b. Apply the overlay when importing nixpkgs c. Access the library using nixpkgs.lib.nix-rice

Example:

let
  nix-rice = builtins.fetchGit {
    url = "https://github.com/bertof/nix-rice.git";
    ref = "refs/tags/v0.3.0";  
  };
  nix-rice-overlay = import (nix-rice + "/overlay.nix");
  pkgs = import <nixpkgs> { overlays = [ nix-rice-overlay ];};
in
{
  # < YOUR CONFIGURATION HERE >
}

Nix-rice with flakes

1. Add nix-rice to your inputs;
2. Access the library, either through nix-rice.lib or, applying the standard overlay, through pkgs.lib.nix-rice.

Example:

{
  inputs = {
    # < OTHER INPUTS HERE >
    nixpkgs.url = "github:NixOS/nixpkgs/release-22.11";
    flake-utils.url = "github:numtide/flake-utils";
    nix-rice = { url = "github:bertof/nix-rice"; };
  };

  outputs = { self, nixpkgs, nix-rice }: 
  let
    overlays = [ nix-rice.overlays.default ];
  in
    flake-utils.lib.eachDefaultSystem (system: 
      let
        pkgs = import nixpkgs { inherit overlays; };
      in
      {
        # < YOUR CONFIGURATION HERE >
      });
}

How to use it

Nix-rice provides a the library module with the following submodules:

• op: extends the standard library with utility functions for managing numbers;
• float: extends the standard library with float-specific functions, like integer division, module operator, ceil, floor and float conversion;
• hex: contains a hexadecimal parser and serializer for integers
• color: contains the logic for color parsing, transformation, serialization and conversion;
• palette: contains the logic for color palette parsing, transformation, serialization and conversion;
• kitty-themes: contains a Kitty terminal configuration parser and theme loader.

The general workflow to use Nix-rice is the following:

1. Define a color palette: you can load any of the themes in Kitty themes or create one from scratch:

with pkgs.lib.nix-rice;
colorPalette = palette.tPalette color.hexToRgba {
  red = "#FF0000FF";
  green = "#00FF00FF";
  green = "#0000FFFF";
  # < ANY OTHER COLOR HERE >
};

color.hexToRgba is applied recursively, so you can have nested or lazy evaluated colors, i.e. you can load your palette from a JSON file and parse it with Nix-rice.

TIP: it's useful to store your parsed palette in your configuration as an overlay, so that you can load it from any package and more uniformly apply transformations:

self: super: with super.lib.nix-rice; let theme = kitty-themes.getThemeByName "Cattppuccin-Mocha"; in {
  rice.colorPalette = rec {
    normal = palette.defaultPalette // {
      black = theme.color0;
      red = theme.color1;
      green = theme.color2;
      yellow = theme.color3;
      blue = theme.color4;
      magenta = theme.color5;
      cyan = theme.color6;
      white = theme.color7;
    };
    bright = palette.brighten 10 normal // {
      black = theme.color8;
      red = theme.color9;
      green = theme.color10;
      yellow = theme.color11;
      blue = theme.color12;
      magenta = theme.color13;
      cyan = theme.color14;
      white = theme.color15;
    };
  } // theme;
}

2. Transform: transform and adapt your palette. Nix-rice provides bidirectional conversion for RGBA and HSLA. For ease of use, Nix-rice also provides brighten and darken functions. Future plans include the extension of transformation functions with several mixing modes.

3. Translate: convert your palette to the most appropriate serialization. Nix-rice provides bidirectional conversion for upper case and lower case versions of RGB, RGBA, ARGB, both with and without the initial #. Convert the palette to its serialized version and use it in your configurations.

   This is example shows part of configuration for BSPWM through home-manager:

   { pkgs, lib, ... }:
   with pkgs.lib.nix-rice;
   let strPalette = palette.toRGBHex pkgs.rice.colorPalette;
   in {
     xsession.windowManager.bspwm = {
       enable = true;
       settings = {
         border_width = 1;
         border_radius = 8;
         window_gap = 2;
         split_ratio = 0.5;
         top_padding = 0;
         borderless_monocle = true;
         gapless_monocle = false;
         normal_border_color = strPalette.normal.blue;
         focused_border_color = strPalette.bright.red;
       };
     };
   }

   This is an example on the integration of Nix-rice with Alacritty through home-manager:

   { pkgs, ... }:
   let
     strPalette = with pkgs.rice;
       pkgs.lib.nix-rice.palette.toRgbHex rec {
         inherit (colorPalette) normal bright primary;
         dim = colorPalette.dark;
         cursor = {
           cursor = normal.white;
           text = normal.black;
         };
         vi_mode_cursor = {
           cursor = normal.white;
           text = normal.black;
         };
         selection.background = dim.blue;
         search = {
           matches.background = dim.cyan;
           bar = {
             foreground = dim.cyan;
             background = dim.yellow;
           };
         };
       };
   in
   {
     # Include fonts packages
     home.packages = [ pkgs.rice.font.monospace.package ];
     programs.alacritty = {
       enable = true;
       settings = {
         # env.TERM = "xterm-256color";
         env.TERM = "alacritty";
         scrolling.history = 3000;
         font = {
           normal.family = pkgs.rice.font.monospace.name;
           size = pkgs.rice.font.monospace.size / 1.5; # Font size is broken
         };
         window.opacity = pkgs.rice.opacity;
         mouse = {
           # hide_when_typing = true;
           hints.modifiers = "Control";
         };
         colors = with pkgs.rice;
           strPalette // {
             selection.text = "CellForeground";
             search.matches.foreground = "CellForeground";
           };
       };
     };
   }

Complete overlay example

This is a complete overlay example saving the theme in the rice derivation. This also includes font configuration and fail safe colors definitions using palette.defaultPalette.

self: super:
with super.lib.nix-rice;
let theme = kitty-themes.getThemeByName "Catppuccin-Mocha";
in {
  rice = {
    colorPalette = rec {
      normal = palette.defaultPalette // {
        black = theme.color0;
        red = theme.color1;
        green = theme.color2;
        yellow = theme.color3;
        blue = theme.color4;
        magenta = theme.color5;
        cyan = theme.color6;
        white = theme.color7;
      };
      bright = palette.brighten 10 normal // {
        black = theme.color8;
        red = theme.color9;
        green = theme.color10;
        yellow = theme.color11;
        blue = theme.color12;
        magenta = theme.color13;
        cyan = theme.color14;
        white = theme.color15;
      };
      dark = palette.darken 10 normal;
      primary = {
        inherit (theme) background foreground;
        bright_foreground = color.brighten 10 theme.foreground;
        dim_foreground = color.darken 10 theme.foreground;
      };
    } // theme;
    font = {
      normal = {
        name = "Cantarell";
        package = self.cantarell-fonts;
        size = 10;
      };
      monospace = {
        name = "FiraCode Nerd Font Mono";
        package = self.nerdfonts.override { fonts = [ "FiraCode" ]; };
        size = 10;
      };
    };
    opacity = 0.95;
  };
}

Updates

While the library interface is mostly set, it might change in the future (new transformations, palette generation, conversion to specific programs configurations). It is therefore suggested to use a pinned version like in the example above.

Contributions

Feel free to modify this library as you please: addition and fixes are welcome. Do yow want to include your favorite theme? Add a new transformation? Send a PR.