OpenCode Wallpapers

Animated wallpapers for the OpenCode terminal UI: slow, quiet scenes behind everything, kept readable behind text.

This project is not affiliated with, endorsed by, or sponsored by OpenCode or its maintainers.

Install

Requires OpenCode 2:

opencode plugin add vaprdev/opencode-wallpapers#release

Update with opencode plugin update. Restart OpenCode after either. If you installed it with git clone before, delete ~/.config/opencode/plugins/wallpapers.

Use

Type /wallpaper to open the menu and pick a wallpaper; none shows until you do. ↑/↓ picks a setting, Enter or ←/→ changes it, Escape closes it.

• Activity: calm, lively or teeming: how much moves behind your work.
• Time of day: day, sunset or night, or auto to follow your clock. Wallpapers with one look keep it.
• Brightness, shuffle, per project and power: subtle to vivid, a new wallpaper every hour, one per project, and slowing down when idle.

Scenes react to your agent: they speed up while it works, a visitor shows up when it finishes, and clouds roll in after an error. With mouse support, clicking empty background nudges the scene, and each wallpaper hides a rare surprise.

Wallpapers

ocean · desert · jungle · space · farm · tundra · beach · city · zen · prehistoric · haunted-house · rider · megacity · dome · flowerbox · maze · pipes · mystify · flying-opencode · universe · matrix

Terminals

Any truecolor terminal works. Ghostty and kitty get finer octant characters; others get quadrant blocks.

Variable	Effect
WALLPAPER_PIXELS=1	In Ghostty or kitty, draw the scene as a real image
WALLPAPER_SUPERSAMPLE=2	Smoother edges, at about 2.5x the CPU
WALLPAPER_OCTANTS=0 or 1	Force quadrant or octant characters
WALLPAPER_SMOOTH=0	Octants without wedges and eighth blocks

Make a wallpaper

See CONTRIBUTING.md.

Gallery

At teeming; the GIFs play at 3x speed.

	Day	Sunset	Night
Ocean
Desert
Jungle
Space
Farm
Tundra
Beach
City
Zen garden
Prehistoric
Haunted house

	Still	In motion
Rider
Megacity
Dome
Flower Box
3D Maze
3D Pipes
Mystify
Flying OpenCode
Universe
Matrix

License

MIT