-
released this
2026-05-09 05:02:23 +00:00 | 0 commits to main since this releaseSummary
🚀 New Features
- XDG Base Directory compliance — all install/config/runtime paths now resolve via
$XDG_CONFIG_HOME,$XDG_DATA_HOME, and$XDG_RUNTIME_DIRwith the conventional defaults (~/.config,~/.local/share,/tmp) as fallbacks.BIN_DIRstays~/.local/binsince no XDG standard covers user binaries. --uninstallflag — removes the binary symlink,.desktopentry, and data directory with colored per-step output and a post-run verification pass. Prompts to remove the config directory when stdin is a TTY; skips the prompt (keeps config) in non-interactive mode.
✨ Enhancements
- xclip advisory —
--check-depsand--installnow emit a yellow warning whenwl-clipboardis absent butxclipis found, explaining that xclip routes through XWayland and may be unreliable on Wayland. - Dependency message cleanup — normalized all clipboard messages to use package names (
wl-clipboard,xclip) consistently. - Readable path output — added
tilde_pathhelper that replaces the$HOMEprefix with~/in any user-facing path string. Applied throughout--help,--install, and--uninstalloutput. Paths outside$HOME(e.g. custom XDG roots) are shown as full absolute paths. All actual file operations continue to use the original absolute paths.
📝 Documentation
- README — updated install steps, usage block, and configuration section to reference XDG variables; added xclip advisory to prerequisites; documented
--uninstall.
Tests
- Improve Legibility — export
XDG_CONFIG_HOME/XDG_DATA_HOMEin the sandbox so the overriddenHOMEis respected (fixes a pre-existing test regression). - Mock Tools — add
cpandlnto mocked tools. - New Test — add test 15 (install verifies XDG file placement).
- New Test — add test 16 (uninstall verifies cleanup with config kept).
Changelog
- docs: link script directly in manual install guide (979c0b7436)
- feat: XDG Base Directory compliance, --uninstall flag, and xclip advisory (075bb10265)
- refactor: apply tilde_path to all user-facing path output (06dd84d3a3)
- fix(deps): dynamic clipboard label and yellow check for xclip-only in --check-deps (ad7a1f15b3)
- fix(tests): redirect stdin from /dev/null in uninstall test to prevent hang (1a27dbde4e)
Downloads
- XDG Base Directory compliance — all install/config/runtime paths now resolve via