Gen-Wal Logo

Gen-Wal

A small experiment born from curiosity. Runs once a day to generate a new desktop wallpaper. Uses minimal text and visual context. Designed to be subtle and ignorable.

curl -sL https://gen-wal.laptopserver.dev/install | bash

Runs locally by default. Optional AI providers can be enabled.

Examples

How It Works

Theme
↓
Quote Provider
↓
Image Provider
↓
Renderer
↓
Wallpaper

CLI

$ genwal preview
$ genwal preview --provider flow
$ genwal theme use stoic
$ genwal schedule set 06:30

Customization

Gen-Wal can generate wallpapers using:

  • β€’ Procedural algorithms (mesh, flow, voronoi, waves)
  • β€’ Your own generator plugins
  • β€’ AI models (OpenAI, Ollama, LMStudio, Gemini)

Plugins

Bring your own generator.

Drop a Python file into:

~/.local/share/genwal/providers/images/

Gen-Wal will automatically discover it.

Desktop Themes

Markdown templates that frame your target mindset, philosophy lists, and ambient visual prompts. Browse the Gallery to adopt a reference frame.

Stoic

"What stands in the way becomes the way."

Zen

"Form is emptiness, emptiness is form."

Deep Work

"Focus is the new IQ."

Browse Gallery

View ready-made templates.
Copy and run in one click.

Themes inject their settings into config.json when applied β€” no runtime parsing.

Other Ideas

Concepts I am exploring.
Let me know if you find these interesting!

πŸ•’ Focus Window

Toggle a specific daily period (e.g., 4-6 PM) to transform the desktop into a deep work mode.

πŸ“š Extended Context

Dynamically generate quotes from a wider range of books, articles, and specific personalities.

🎯 Daily Intent

Input a single focus task for the day, and let the wallpaper quietly reinforce it.

🌊 Temporal Shifting

Automatically shift wallpaper mesh vectors from morning focus tones to evening wind-down aesthetics.

If you have ideas, open an issue.

If this resonates, star on GitHub.

Command Copied! πŸ“‹