# Luthien Templates

`luthien-templates` renders user-defined Handlebars templates with Luthien theme data.

## Installation

Install using Cargo from Crates.io:

```bash
cargo install luthien-templates
```

## Configuration

Add a plugin to your Luthien config:

```toml
[[plugins]]
executable = "~/.cargo/bin/luthien-templates"
```

## Writing Templates

Mustach templates in the plugin's config directory (should be something like `~/.config/luthien/plugins/templates`) will be rendered using the theme data.

### Template Data

The data accessible to the template looks like this (in some TypeScript-like pseudocode):

```typescript
type Color = {
  hex: string;
  hex_stripped: string;
  red: number;
  green: number;
  blue: number;
};

// The RGB channels are sRGB floating-point values from 0 to 1

type Data = {
  wallpaper: string;
  colors: {
    palette: {
      black: Color;
      red: Color;
      green: Color;
      yellow: Color;
      blue: Color;
      purple: Color;
      cyan: Color;
      white: Color;
    };
    accents: Color[];
    foreground: Color;
    background: Color;
  };
};
```

`colors.accents` is a list of accent colors in descending order of importance, so low-indexed colors should be used more often. There should be at least 6 accents.

## Outputs

The rendered template is then copied into a file in the output directory (should be something like `~/.local/share/luthien/outputs/plugins/templates` on Unix-like systems).