Installations

npm install unspray

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

8.1.1

NPM Version

5.0.3 Pull Requests

Open

0

Total

0

Closed

0

Issues

Open

0

Total

0

Closed

0

Releases

1

v1.0.1

Updated on Jun 14, 2017

View All 1 releases

Languages

1

JavaScript

JavaScript (100%)

Developer

bernardop

Download Statistics

Total Downloads

0

Last Day

0

Last Week

0

Last Month

0

Last Year

0

GitHub Statistics

14 Commits

1 Watchers

1 Branches

1 Contributors

Updated on Jun 14, 2017

Maintainers

1

View All 1 Contributors

Package Meta Information

Latest Version

1.0.1

Package Id

unspray@1.0.1

Size

3.34 kB

NPM Version

5.0.3

Node Version

8.1.1

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

0%

NaN

Compared to previous day

Last Week

0%

NaN

Compared to previous week

Last Month

0%

NaN

Compared to previous month

Last Year

0%

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

8

chalk commander figlet imgcat ora request request-promise wallpaper

Unspray

A CLI for interacting with Unsplash.com

Installation

npm install -g unspray

or

yarn global add unspray

Configuration

Create a .unsprayrc file in your home directory with your Unsplash.com Application ID. If you don't have an Application ID, you will need to create an Unsplash.com developer account and register an application.

{
    "applicationID": "<YOUR_APPLICATION_ID_HERE>"
}

Usage

There are 3 commands available in unspray

Search

Search Unsplash.com for photos

unspray search -q "search query" -p 1 -r 5

Options

-q or --query - Search query (required)
-p or --page - Page number to retrieve (optional; default: 1)
-r or --results-per-page - Number of items per page (optional; default: 10)

Note: if you use iTerm2 v2.9+ you can see thumbnails of the results right in your terminal!

Save

Save a photo to your computer

unspray save -i "photo-id" -d "directory" -Q "quality"

Options

-i or --photo-id - Photo ID (optional; if not provided, a random photo is retrieved)
-d or --directory - A directory relative to your home directory (optional; default: Desktop)
-Q or --quality - Quality of photo to save (thumb, small, regular, full). (optional; default: regular)

Set as wallpaper

Set a photo as your wallpaper

unspray set-wallpaper -i "photo-id" -d "directory" -Q "quality" -s "scale"

Options

-i or --photo-id - Photo ID (optional; if not provided, a random photo is retrieved)
-d or --directory - A directory relative to your home directory (optional; default: Desktop)
-Q or --quality - Quality of photo to save (thumb, small, regular, full). (optional; default: regular)
-s or --scale - Scaling method to use for the wallpaper (fill, fit, stretch, center). (optional; default: fill)

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

0

SAST

Determines if the project uses static code analysis.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

License

Determines if the project has defined a license.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

1.3

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More