Clairlune
Procedural, animated ASCII-art desktop wallpapers, written in Rust.
Each wallpaper is a landscape made of text characters, with a small pixel-art Clawd doing something in it and a few things moving: embers, snow, stars. Everything is generated on your computer from a seed, and the same seed gives the same picture everywhere. There's no AI and nothing about you goes online: Clairlune checks GitHub once a day for a newer version (you can turn that off in Settings -> General), and downloads one only when you click Update now.

Unofficial fan project. Not affiliated with or endorsed by Anthropic. Clawd is Anthropic's character.
Download · User guide · Changelog
Status
Usable every day on Windows and macOS, where the tray or menu bar app is the main way to use it. The Linux build hasn't been tried on real desktops yet, so reports are welcome. There are sixteen landscapes (from canyons and snowfields to a volcano, palm islands, a bamboo grove and the Moon), thirty-two things Clawd can be doing, eleven kinds of weather (petals, fog, blizzards and falling ash among them), and two looks: line art, or a dithered version built from dots and bars. Seven of the activities are journeys, where the land in front scrolls past a big still landmark (a dome, a peak, a volcano, a mesa, a rising moon): a ridge hike, ski touring, sledding, a forest walk, a desert trek, and flights on the broom or in the balloon. The roadmap is in PLAN.md.
Install
Get the installer for your system from the Releases page:
- Windows:
clairlune_<version>_x64-setup.exe. It installs for your account only, so it doesn't need administrator rights. Uninstall it from Settings > Apps. - macOS:
Clairlune_<version>_aarch64.dmg(Apple Silicon) orClairlune_<version>_x64.dmg(Intel). Drag Clairlune to Applications. The app isn't notarized, so macOS refuses to open it the first time; go to System Settings > Privacy & Security and click Open Anyway. - Linux: the
.deb(sudo apt install ./clairlune_<version>_amd64.deb) or the AppImage. An AUR package is on the way.
Or use a package manager:
- Homebrew:
brew install --cask yam333/clairlune/clairlune - Scoop:
scoop bucket add clairlune https://github.com/yam333/homebrew-clairlune, thenscoop install clairlune - winget:
winget install Clairlune.Clairlune(once Microsoft accepts the package) - Cargo:
cargo install clairlune, orcargo install --path crates/appfrom a checkout
Clairlune lives in the notification area (Windows) or the menu bar (macOS) as a moon icon. The first time you open it, it asks whether to start quietly when you sign in.
Using the app
It sets a new wallpaper when it starts and then every hour, with a separate scene on each monitor. By default the scene plays live behind your desktop icons, and it pauses on a monitor while a maximized or full-screen app covers it. Settings -> Display switches to a still frame; Settings -> Live sets the frame rate (6 to 60 a second, 12 by default).
On Windows, double-click the moon to open Settings and right-click it for the menu. From the menu you can get a new wallpaper (on every monitor, or just one), go back to the previous one, switch theme, pause the changes, save the current wallpaper as a PNG or GIF, and open the Archive, Library and Timeline windows.
The Archive keeps the last week of wallpapers so you can reuse, pin or export them. Save to library keeps one for good; it's stored as a frozen scene, so it looks the same after updates. With Settings -> Rotation set to Timeline, the app follows a daily plan instead of the hourly change: drag saved wallpapers or random scenes onto a 24-hour bar for each day, and pick each slot's theme.
Settings also covers which landscapes, activities and weather to use, the look and contrast, the zoom (Clawd up close, smaller, or tiny in a huge landscape), Clawd on or off, start at login, hiding the moon icon (open Clairlune again to get back to Settings), and Restore my wallpaper, which puts back the wallpaper you had before Clairlune. With more than one monitor, each can keep the still frame while the others play live (Display), or pick from its own landscapes and activities (Content).
When a newer version is out, Settings -> General and the menu offer it: Update now downloads it from GitHub, checks it against the checksum GitHub lists, installs it and starts Clairlune again (installs from Scoop, cargo or the .deb update the usual way instead). Report a problem, next to it, opens a new GitHub issue with the version, system, monitors and recent log lines filled in; you see them in Settings first, and nothing is sent until you send the issue. Settings live in %APPDATA%\clairlune\settings.toml and logs in %LOCALAPPDATA%\clairlune\logs.
On Linux the app sets the wallpaper on GNOME, Cinnamon, MATE, KDE Plasma, XFCE and Sway, and on other Wayland compositors with the wlr layer shell (Hyprland, river, Wayfire, labwc) it shows the wallpaper itself while it runs. Live wallpapers work there and on X11 window managers without a desktop of their own (i3, Openbox, bspwm). GNOME, KDE, XFCE, Cinnamon, MATE and LXQt draw their own desktop icons, so they get the still frame. On macOS it sets a scene on each screen, and Settings -> General -> Screen saver makes the wallpaper the screen saver too (pick Clairlune in System Settings -> Screen Saver when it opens). On Linux, Live is off by default until it's tried on more desktops; turn it on in Settings.
The command-line tool
clairlune-cli renders wallpapers without the app:
| Flag | Meaning |
|---|---|
--seed <u64> |
Scene seed. Leave it out for 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, such as stroll or hike_ridge. An unknown id lists them all. |
--archetype <id> |
Force a landscape: canyon, mountains, forest, desert, snowfield, shore, city_rooftops, night_sky, cave, interior. |
--look <look> |
line or dither. |
--contrast <c> |
soft, normal, high, or vary (one per seed). |
--no-buddy |
The same scene without Clawd. |
--recipe-out <path> |
Also write the scene recipe as JSON. |
--time-ms <t> |
Render a given moment instead of the default frame. |
A looping GIF, 6 or 12 seconds long (--smoothness battery-saver|balanced|smooth|very-smooth|ultra-smooth):
A frozen scene package holds everything a scene needs to play, about 0.5-1 MB at 4K, and it plays the same after the generator changes:
Many seeds in one grid, to check variety:
Set wallpapers directly (Windows):
The main monitor gets the seed you give and the others get seeds derived from it, so the same seed always gives the same set. The first set remembers your wallpaper so restore can bring it back.
Play live wallpapers for a while and see what they cost (Windows, Linux):
On Windows this leaves the still frame as your wallpaper when it ends; clairlune-cli restore undoes that. On Linux it never touches the wallpaper.
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. |
clairlune-live (crates/live) |
Live wallpapers: plays a scene behind the desktop icons, uploading only what changed. |
clairlune (crates/app) |
The tray app and Settings window (egui). |
Generated images
With Clawd turned on, wallpapers contain fan art of Anthropic's character, so be careful if you publish or sell them. Images made with --no-buddy contain only this project's own work.
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.
