# HyprTile MoodGrade Pack

A cinematic wallpaper beautification pack for `hyprtile-wallpaperd`.

This pack is intentionally **not** about text, audio or gimmicks. It is a pure mood-and-grade pack that enhances static images and wallpapers so they immediately feel more atmospheric, polished and filmic.

## Included Signature Presets

### 1. Golden Hour
A warm prestige-cinema look:
- soft halation around brighter parts of the image
- subtle warm split-toning
- gentle golden light sweep
- controlled vignette and film grain

Best for:
- landscapes
- cityscapes at sunset
- portraits / character art
- dramatic fantasy artwork

### 2. Noir Glass
A cool, moody night-grade:
- cyan-leaning shadows and restrained highlights
- micro-contrast and light sharpening
- very subtle chromatic separation at the edges
- center spotlight with deep vignette

Best for:
- cyberpunk / noir art
- dark wallpapers
- rainy scenes
- architecture and urban images

### 3. Dream Matte
A soft editorial diffusion look:
- low-opacity half-resolution diffusion pass
- pastel split-toning
- lifted blacks and reduced harshness
- soft haze, matte finish and mild grain

Best for:
- illustration
- anime / painterly art
- soft nature wallpapers
- calm, dreamy desktop moods

## Directory Layout

```text
hyprtile-moodgrade-pack/
├── golden-hour.frag
├── noir-glass.frag
├── mist-diffuse.frag
├── dream-matte.frag
├── default.wallpaper
├── default.params
├── golden-hour.wallpaper
├── golden-hour.params
├── noir-glass.wallpaper
├── noir-glass.params
├── dream-matte.wallpaper
├── dream-matte.params
└── README.md
```

## Installation

Copy the folder into one of HyprTile's shader-pack search paths:

```bash
mkdir -p ~/.hyprtile/shader/wallpaperd
cp -r hyprtile-moodgrade-pack ~/.hyprtile/shader/wallpaperd/
```

## Example Commands

```bash
hyprtile-wallpaperd --image wallpaper.webp --pack moodgrade:golden-hour
```

```bash
hyprtile-wallpaperd --image wallpaper.webp --pack moodgrade:noir-glass
```

```bash
hyprtile-wallpaperd --image wallpaper.webp --pack moodgrade:dream-matte
```

Default preset:

```bash
hyprtile-wallpaperd --image wallpaper.webp --pack moodgrade
```

## Technical Notes

- GLSL ES 1.00 / OpenGL ES 2 compatible
- chain-friendly: every pass samples `u_tex`
- no Y-flip hacks
- no invented uniforms or textures
- no audio usage
- no text usage
- no history usage
- optional built-in noise texture used for organic film grain
- `Dream Matte` uses a genuine multipass design for diffusion + final grade

## Performance

- `Golden Hour`: single pass, 9-tap soft glow + grain
- `Noir Glass`: single pass, 7-ish effective samples + grain
- `Dream Matte`: one reduced-scale diffusion pass plus one lightweight final grade

Designed to stay aesthetically rich while remaining suitable for desktop wallpaper use, including on modest GPUs.
