Wallzer Lua scripts can drive wallpapers, desktop extensions, widgets, visual effects, and lightweight interactive scenes.
This documentation set is generated from resources/lua/wallzer.lua and split into small pages so the website, GitHub, and future in-app docs can all read the same files.
- Live wallpapers with media-aware effects.
- Desktop widgets and extensions.
- Cursor-reactive visual effects.
- Discord, Cider, and Spotify reactive scenes.
- Lightweight interactive desktop toys and games.
- Use
wallzer.on_update(callback)for state changes and physics. - Use
wallzer.on_draw(callback)for drawing custom shapes, text, sprites, and effects. - Coordinates are in wallpaper canvas pixels.
- Color channels are normalized floats from
0.0to1.0. - Assets are resolved from the current wallpaper or extension package.
| Page | APIs |
|---|---|
| Lifecycle | 2 |
| Transforms and layer state | 6 |
| Runtime input and environment | 8 |
| Drawing | 10 |
| Image effects | 6 |
| Integrations | 6 |
| Audio | 2 |
| Math and collision helpers | 6 |
This docs set currently covers 46 public wallzer.lua APIs.