r/suckless • u/oriunn • 53m ago
[SOFTWARE] I made twall, a small wallpaper picker that just lists files and applies one
I built twall because I wanted a picker that does not stick around. It lists files, applies one, exits. The only thing that stays alive is your wallpaper client (swaybg by default, or whatever you put in config.h). Wayland wallpapers are just clients on a layer surface, but twall itself is not tied to Wayland. Change cmd[] and it works with feh, xwallpaper, nitrogen, whatever.
No daemon on twall's side. No swww/awww daemon either, The default command starts a new swaybg, waits for its PID, kills the old one. On my box that is 60+-5 ms
No preview on purpose. Preview means chafa or some image library, and then you are porting rendering to every terminal people use. twall keeps the dependency list at libc and POSIX. If you want to see the image, open it in your image viewer. The picker stays a picker.
What it does:
lists regular files with extensions in exts[]
natural sort, scrollbar, filter with /
Enter keeps the query, Esc clears it
Enter or Space applies and keeps the window open
q, Esc, Ctrl-C quit
-p prints the path, no apply
-r restores last, -R random
Tab cycles outputs if cmd_out[] is set
Config is compile time. Edit config.h and rebuild. No JSON, no TOML, no daemon to restart.
Build:
git clone https://github.com/tinyopsec/twall
cd twall
make
sudo make install