What is this?

A lightweight shell + preset system that gives each new Wave tab a random background image, applied before the shell prompt even appears — completely zero latency.

How it works

Two mechanisms run in parallel:

1. Tab creation time — Wave reads tab:background from settings.json (set by the previous tab) and applies the preset CSS before rendering the terminal → instant
2. Shell startup — .zshrc at the very top picks a random image, applies it via wsh setbg, and rotates tab:background for the next tab

 Tab 1 opens → gets preset bg@custom042 (instant, at tab creation)
      └── .zshrc: wsh setbg random.jpg + set tab:background = bg@custom123
 Tab 2 opens → gets preset bg@custom123 (instant)  ← set by tab 1
      └── .zshrc: wsh setbg random.jpg + set tab:background = bg@custom307
 Tab 3 opens → gets preset bg@custom307 (instant)  ← set by tab 2

No plugins, no forks — just shell scripts and Wave config files.

Quick install

git clone https://github.com/wait2050/wave-random-bg.git
cd wave-random-bg
zsh install.sh ~/Pictures/wallpapers 0.3

Links

• Repo: https://github.com/wait2050/wave-random-bg
• 中文文档: https://github.com/wait2050/wave-random-bg/blob/main/README_zh.md

Built with the help of Claude & DeepSeek.