clairlune 0.8.0

Procedural, animated ASCII-art desktop wallpapers. Local, seeded and deterministic; no AI, no network.
clairlune-0.8.0 is not a library.

Clairlune

Procedural, animated ASCII-art desktop wallpapers, written in Rust.

Every wallpaper is generated locally from a seed: a landscape built from text glyphs, a small pixel-art buddy doing something in it, and a few animated details such as embers, snow or stars. Generation is deterministic, so the same seed gives the same picture on every computer. There is no AI and no network access at runtime.

Nine generated wallpapers, one per landscape, in dark and light themes

Unofficial fan project. Not affiliated with or endorsed by Anthropic. Clawd is Anthropic's character.

Status

Early development. The generator and a developer CLI work today: nine landscapes (canyon, mountains, forest, desert, snowfield, shore, city rooftops, night sky, cave), seven activities for Clawd, weather, stills and seamless looping GIFs. On Windows the tray app already runs: a new wallpaper on a schedule, one scene per monitor, an archive of past ones, a library of the ones you keep and a daily timeline. Live (animated) wallpapers and the other systems come in later milestones; see PLAN.md.

Try the generator

cargo run --release -p clairlune-cli -- generate --seed 7 --theme dark --size 3840x2160 --out wallpaper.png

Options:

Flag Meaning
--seed <u64> Scene seed. Omit it to get a random one (printed).
--theme light|dark Palette and time of day.
--size <W>x<H> Output size in pixels.
--out <path> Output PNG (indexed, at most 255 colours).
--activity <id> Force an activity: warm_hands, stroll, stargaze (night only), wizard_magic, make_coffee, read_lantern, play_guitar.
--archetype <id> Force a landscape: canyon, mountains, forest, desert, snowfield, shore, city_rooftops, night_sky, cave.
--no-buddy Render the same scene without the character.
--recipe-out <path> Also write the scene recipe as JSON.
--time-ms <t> Render a specific animation time instead of the hero frame.

To share an animated version, export a seamless looping GIF (6 s or 12 s; --smoothness battery-saver|balanced|smooth|very-smooth|ultra-smooth):

clairlune-cli gif --seed 7 --activity warm_hands --size 960x540 --out campfire.gif

Saved wallpapers are kept as frozen scene packages: the generator's output (backgrounds, palettes, the scene's layout and animation data, only the sprite frames it uses), so they play the same after later versions change the generator. About 0.5-1 MB for both themes at 4K.

clairlune-cli package --seed 7 --size 1920x1080 --out scene7       # freeze a scene
clairlune-cli generate --package scene7 --theme light --out still.png
clairlune-cli gif --package scene7 --out scene7.gif

To check variety, render many seeds into one grid:

clairlune-cli contact-sheet --count 12 --theme dark --out sheet.png
clairlune-cli contact-sheet --activity stroll --count 8 --out strolls.png
clairlune-cli contact-sheet --archetype shore --count 6 --theme light --out shores.png

The tray app (Windows)

cargo install clairlune      # or, from a checkout: cargo run --release -p clairlune
clairlune

A moon appears in the notification area. The app sets a new wallpaper at start and then every hour, one scene per monitor at each monitor's resolution, and keeps the last week in an archive. The menu has New wallpaper, Previous wallpaper, Theme (Follow system / Light / Dark), Pause schedule, Save current as PNG or GIF (to Pictures\Clairlune), Save to library, Library, Timeline, Open archive folder, Settings and Quit. Launching it again opens Settings.

Library and timeline. Save to library keeps a wallpaper for good, as a frozen scene that plays the same after updates. The Library window lists them to use, rename, export or delete. With Settings > Rotation set to Timeline, the app follows a daily plan instead of the hourly schedule: the Timeline window shows a 24-hour bar for every day (or one per weekday) where you drag saved wallpapers or random scenes in, drag a slot's edge to move its start, double-click to split, and pick each slot's theme and Clawd. It is stored in %APPDATA%\clairlune\timeline.toml and follows daylight saving changes without skipping or repeating a slot.

Settings shows the wallpaper on screen and covers the schedule, theme, which landscapes, activities and weather to use, Clawd on or off, the archive, exports, start at login, and Restore my wallpaper: before its first change the app remembers your own wallpaper, and this puts it back (so does clairlune-cli restore). Settings are stored in %APPDATA%\clairlune\settings.toml, logs in %LOCALAPPDATA%\clairlune\logs.

On Linux the app uses a StatusNotifier tray icon and sets the wallpaper on GNOME, Cinnamon, MATE, KDE Plasma, XFCE and Sway (one image for all monitors; not yet tried on real desktops, reports welcome). On macOS it runs and archives scenes but can't set the wallpaper yet. Live (animated) wallpapers come in a later version.

Set it as your wallpaper from the CLI (Windows)

clairlune-cli monitors                 # ids, physical sizes, current wallpapers
clairlune-cli set --seed 7             # one scene per monitor, at each monitor's resolution
clairlune-cli set --archetype shore --theme light
clairlune-cli restore                  # put back the wallpaper you had before

The primary monitor gets the seed you give; the others get seeds derived from it and their monitor id, so each screen has its own scene and the same seed always gives the same set. The first set remembers your current wallpaper (per monitor, and the fit mode) so restore can put it back. Stills are kept in %LOCALAPPDATA%\clairlune\current, each under a new file name. macOS and Linux follow in this milestone.

Workspace

Crate Purpose
clairlune-scene (crates/scene) Pure, deterministic: seed → recipe → scene graph. No I/O.
clairlune-sprites (crates/sprites) Aseprite sheet loader, anchors, the Character trait.
clairlune-render (crates/render) Glyph atlas, palette-index compositor, PNG export.
clairlune-cli (crates/cli) Developer tool.
clairlune-platform (crates/platform) Monitors, setting the wallpaper, login items (Windows today).
clairlune (crates/app) The tray app and Settings window (egui).

Generated images

With the buddy turned on, wallpapers contain a drawing of Clawd, which is Anthropic's character. If you publish or sell generated images, that is fan art and the same caution applies. With --no-buddy, images contain only this project's own content.

License

Code: either of MIT or Apache-2.0, at your option.

The bundled fonts, JetBrains Mono and IBM Plex Sans, are under the SIL Open Font License 1.1 (JetBrains Mono, IBM Plex Sans).

Clawd artwork is fan art and is not covered by the code licence. See NOTICE.