Splash CLI

splash-cli

A simple CLI to download Unsplash wallpapers. Nothing fancy, it just works.

Runs as splash|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 7 fields

Download an Unsplash photo and set it as wallpaper, or only save it. Collection, topic and user filters, scale, screen and the auth/alias/settings subcommands are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui splash-cli

Get an Unsplash photoExample values, fixed in this page — nothing here reaches a terminal

Basic

Search term*

string

Orientation

landscapestring

TasksEach one presets the form for one job

Wallpaper from a search

queryorientation

Photo of the day

daysave

ParametersOnly these flags are editable in the form

Search term

string

--query-q

Orientation

string · default: landscape

--orientation-olandscapeportraitsquarish

Photo of the day

boolean

--day

Photo ID

string

--id

Save only (do not set wallpaper)

boolean

--save-s

Ignore cache

boolean

--no-cache

Plain output

boolean

--plain

SourcesEvery flag above is checked against these

help

$ splash --day $ splash --query "mountains" --orientation "landscape" --day Retrieve the photo of the day --id string Retrieve a single photo by ID --no-cache Ignore cache -o, --orientation string Filter by photo orientation (default "landscape") --plain Plain output. Goo…

help

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed splash against its version. A form that does not match your version is not offered.