Skip to content
๐Ÿ“ธ Beautiful wallpapers from Unsplash ๐Ÿ–ผ๏ธ๐Ÿ› ๏ธ
JavaScript HTML
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Updated with tests Oct 28, 2018
.vscode Merge from master to dev (#39) Feb 3, 2019
documentation preparing 3.3.4 May 14, 2019
example fixes Nov 16, 2018
src help menu improvements May 14, 2019
.babelrc new babel-plugins Apr 23, 2019
.eslintrc.json config Nov 3, 2018
.gitignore Fix wrong imported function from utils (#45) (#46) May 3, 2019
.jsbeautifyrc config Nov 3, 2018
.npmignore Merge from master to dev (#39) Feb 3, 2019
.travis.yml travis fix maybe Jun 5, 2018 permissions stuff Nov 3, 2018 Updated some links to old stuff May 19, 2019
package.json updated homepage May 14, 2019
test.js cleanup May 14, 2019

npm Version Travis CI
Website GitHub issues

Splash CLI

Get stunning wallpapers from Unsplash

Splash CLI is an Unsplash client powered by NodeJS. You can use it as an Unsplash terminal client, for example you can:

  • Change wallpaper on your desktop

  • Like or download photos.

  • Create new collections

  • Edit collections

  • Upload photos (See #47)

Terminal Setup

๐Ÿ”ฅStockPapers๐Ÿ”ฅ now available on AppStore

๐Ÿ’พ Installation

To install splash-cli you must use a node package manager such as yarn or npm.

	#ย With NPM
	$ npm install --global splash-cli

	# With Yarn
	$ yarn global add splash-cli

โ“ FAQs

A list of Frequently Asked Questions (FAQ) can be found here

- What is Splash CLI?

Splash CLI is an Unsplash client powered by NodeJS.

You can use it to:

  • Change wallpaper on your desktop.
  • Create new collections (soon)
  • Like or download photos.
  • Download photos by ID.
  • Pick random photo from an user or a collection.

- Why did you make it?

When I wrote Splash CLI it was just for fun, I never tought that someone could find this tool so useful/funny ๐Ÿ˜…

๐Ÿพ Usage

Splash is easy and quick to use, just run splash to get started.

  Get beautiful wallpapers from unsplash.

  Usage [v3.1.1]

  	$ splash [command] [flags]

  	settings <get|set|restore>	GET/SET/RESTORE SETTINGS
  	alias <get|set|remove>		GET/SET COLLECTION ALIASES
  	collection <get|delete>		MANAGE COLLECTIONS
  	dir <clean|get|count>		MANAGE THE DOWNLOAD DIRECTORY
  	user <login|logout|get|...> 	MANAGE USER LOGIN/LOGOUT - GET USER INFOS
  		use `user help` for more options

  	-h --help			THIS MESSAGE
  	-v --version			v3.1.1

  	--scale <auto|fill|fit|stretch|center>  SET WALLPAPER SCALE
  	--screen <all|main|monitor number>	SET AS WALLPAPER ON SELECTED MONITOR

  	-s --save [optional_path] 	DOWNLOAD WITHOUT SETTING AS WALLPAPER

  	-i --info			SHOW EXIF
  	-q --quiet			NO OUTPUT

  Source Filters
  	-c --curated			RANDOM CURATED PHOTO
  	-u --user <username>		RANDOM PHOTO FROM PROVIDED USER

  	--id <id or url>		PHOTO BY ID
  	--collection <id or alias>	RANDOM PHOTO FROM PROVIDED COLLECTION

  Search Filters
  	--query <query>			RANDOM FROM QUERY

Suggested Collections

  • Editorial (317099) - A collection of beautiful photos, curated by the Unsplash Team.

  • Wallpapers (1065976) - Free stunning HD wallpapers for your mobile and desktop screens.

  • Textures & Patterns (3330445) - Find your next perfect texture or pattern in high-quality.


List of awesome people that have helped to keep this project alive:

How can I contribute?

Hi thank you for the interest! Here you can find all what you need to know about and here you can find some things that I'd like to improve.

๐Ÿ‘พ Related Stuff

Made with love by Federico Vitale in ๐Ÿ‡ฎ๐Ÿ‡น

Twitter - Official Website - Instagram

You canโ€™t perform that action at this time.