• 1.4.0 aa32a90d11

    v1.4.0 Stable

    smgr released this 2025-12-11 05:39:10 +00:00 | 3 commits to master since this release

    New hues and CLI tool

    v1.4.0 introduces a few changes that broaden the accessibility of the monobiome model:

    Hue coverage: the canonical monobiome palette for terminals and editors still uses just five accents: red, orange, yellow, green, and blue. For wider use cases and alternative editor themes, cyan/violet/magenta accents have been added, with hues interpolated radially w.r.t. the existing accents. Associated monotones are reef/heathland/moorland, respectively.

    Chroma curves Color trajectories
    cstar-curves.png trajectories.gif
    Palette
    palette.png

    Dynamic theme generation CLI: because monobiome is ultimately just a collection of Bézier curves in OKLCH space, one can generate perceptually uniform themes under arbitrary monotones by calculating the accent colors equidistant from that base. This is equivalent to determining the points at which a sphere centered at the monotone base intersects the accent curves; the radius of such a sphere effectively determines the theme contrast, and the colors on the sphere surface are equally perceptually distinct relative to the background.

    Figures below depict this process; -l 20 -d 0.3, for instance, indicates a base lightness of 20 an OKLCH distance of 0.3.

    -l 20 -d 0.3 -l 20 -d 0.4 -l 20 -d 0.5
    mb_b20_d30 mb_b20_d40 mb_b20_d50
    -l 25 -d 0.3 -l 25 -d 0.4 -l 25 -d 0.5
    mb_b25_d30 mb_b25_d40 mb_b25_d50
    -l 30 -d 0.3 -l 30 -d 0.4 -l 30 -d 0.5
    mb_b30_d30 mb_b30_d40 mb_b30_d50

    The CLI binary can be installed via uv tool install monobiome. There are currently two subcommands, palette for exporting the full palette and scheme for generating parameterized schemes:

    monobiome palette [-h] [-n {hex,oklch}] [-f {json,toml}] [-o OUTPUT]
    
    monobiome scheme [-h] [-m {wcag,oklch,lightness}] [-d DISTANCE] [-o OUTPUT] [-l L_BASE] [--l-step L_STEP] [--fg-gap FG_GAP] [--grey-gap GREY_GAP]
                            [--term-fg-gap TERM_FG_GAP]
                            {dark,light} {alpine,badlands,chaparral,savanna,grassland,reef,tundra,heathland,moorland}
    
    Downloads