/splash-cli

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

Primary LanguageGo

Splash CLI v4

Go

Are you looking for the v3.x splash-cli? Check out the master branch

A new era for Splash CLI is coming! After many weeks thinking how to upgrade the project codebase I decided to completely rewrite the CLI from the ground in Go.

The idea is to replicate the original functionality to keep the new experience as close to the original as possible.

Why Go?

  • Distribution will not depend on NPM
  • No need to install any dependencies
  • Lighter bundle size
  • No need to use any build tools
  • Blazing fast (~2500%) (0.22s vs 5s)

Feature List

  • Change wallpaper on your desktop
  • Download photos
  • Login to your account
  • Create new collections
  • Add photos to collections
  • Like photos
  • More to come

Installation

Via Homebrew

brew tap rawnly/tap
brew install splash-cli

Via Go

go install github.com/rawnly/splash-cli@latest

Be sure to set up your environment before running the command. Required environment variables are:

  • UNSPLASH_CLIENT_ID
  • UNSPLASH_CLIENT_SECRET

You can get credentials on the Unsplash Developer Portal.

Also remember that the BIN name will be splash-cli and not splash

Manually

Build Locally

To build the project locally you can use the following command:

    goreleaser --snapshot --rm-dist
    
    # Or
    
    make build # this will only build for the current platform

Note If you have an .env file in your project root make will automatically inject values inside script commands.

Be sure to set up your environment before running the command. Required environment variables are:

  • UNSPLASH_CLIENT_ID
  • UNSPLASH_CLIENT_SECRET

You can get credentials on the Unsplash Developer Portal.