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

    # 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:

• mohnjatthews
• alecrust

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

• Splash CLI Website — Powered by

  Next.js

  you can take a look at the code here.
• 🔥StockPapers 🔥 — Looking for mobile wallpapers? StockPapers is the solution!
• Unsplash — Free do whatever you want high-resolution photos.
• Collections Downloader — Download Unsplash collections (written in Python)

Made with love by Federico Vitale in :it:

Twitter - Official Website - Instagram