Need help with splash-cli?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

splash-cli
433 Stars 28 Forks Other 417 Commits 4 Opened issues

Description

A simple, command line tool to download Unsplash wallpapers. It’s not intended to be anything particularly fancy — it just works.

Services available

!
?

Need anything else?

Contributors list

Splash CLI - Beautiful wallpapers from Unsplash in your terminal 🖼️🛠️ | Product Hunt Embed

splash-cli

npm Version GithubWorkflow Website

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

:eyes: Looking for maintainers! :eyes:

:floppy_disk: 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 😅

:paw_prints: Usage

Splash is easy and quick to use, just run

splash
to get started.
  Get beautiful wallpapers from unsplash.

Usage [v3.4.15]

    $ splash [command] [flags]

Commands settings GET/SET/RESTORE SETTINGS alias GET/SET COLLECTION ALIASES collection MANAGE COLLECTIONS dir MANAGE THE DOWNLOAD DIRECTORY user MANAGE USER LOGIN/LOGOUT - GET USER INFOS ------------------------------------------------------------------------- HINT: use [command] help for the list of all options

Options -h --help THIS MESSAGE -v --version v3.4.14

    --scale <auto>  SET WALLPAPER SCALE
    --screen <all number>      SET AS WALLPAPER ON SELECTED MONITOR

    -s --save [optional_path]       DOWNLOAD WITHOUT SETTING AS WALLPAPER
    --set <path>                    SET GIVEN PHOTO AS WALLPAPER

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

Image Manipulation --rotate ROTATE THE IMAGE BY GIVEN DEGREES --grayscale MAKES THE IMAGE BW --flip FLIP THE PHOTO ON THE "Y" AXIS --colorspace CHANGE IMAGE "COLORSPACE"

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

    --day                           GET THE PHOTO OF THE DAY
    --id <id or url>                PHOTO BY ID
    --collection <id or alias>      RANDOM PHOTO FROM PROVIDED COLLECTION

Search Filters -f --featured LIMIT TO ONLY FEATURED PHOTOS --query RANDOM FROM QUERY --orientation SET WALLPAPER ORIENTATION (DEFAULT: 'landscape')

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.


Contributors

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.

:space_invader: Related Stuff


Made with love by Federico Vitale in :it:

Twitter - Official Website - Instagram

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.