A command-line tool to download and set Unsplash wallpapers directly from your terminal.
Splash CLI is a command-line interface tool that downloads wallpapers from Unsplash and sets them as desktop backgrounds. It solves the problem of manually browsing for wallpapers by providing a fast, scriptable way to access Unsplash's vast library of high-quality images directly from the terminal.
Developers, power users, and anyone who prefers terminal-based workflows for desktop customization and automation.
It offers a simple, reliable, and efficient way to manage wallpapers without a graphical interface, with features like query-based search, collection aliases, and multi-screen support that cater to technical users.
A simple, CLI to download Unsplash wallpapers. Nothing fancy — it just works.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Installation via Homebrew is a one-liner, and manual setup with pre-built binaries is straightforward, as detailed in the README's installation section.
Plain output mode allows photo URLs or data to be piped into other commands, enabling easy automation in shell scripts, as shown in the usage flags.
Support for aliasing collections lets users quickly access curated wallpaper sets, with dedicated commands for CRUD operations, enhancing workflow efficiency.
Caching of photos reduces API calls and improves speed, with a --no-cache flag for control, as mentioned in the features and usage.
Multi-screen support is restricted to macOS only, as indicated by the --screen flag's note, limiting functionality on other operating systems.
Requires setting up Unsplash API credentials via environment variables, adding an extra step and dependency on external service registration.
When installing via Go, the binary is named 'splash-cli' instead of 'splash', leading to potential confusion, as noted in the README tip.