Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rawnly/splash-cli
A simple, CLI to download Unsplash wallpapers. Nothing fancy — it just works.
https://github.com/rawnly/splash-cli
beautiful-photos beautiful-wallpapers change-wallpaper cli download-photos photography photos splash unsplash wallpaper wallpapers
Last synced: 2 months ago
JSON representation
A simple, CLI to download Unsplash wallpapers. Nothing fancy — it just works.
- Host: GitHub
- URL: https://github.com/rawnly/splash-cli
- Owner: rawnly
- Created: 2016-12-22T02:36:28.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-01-21T15:06:30.000Z (9 months ago)
- Last Synced: 2024-05-02T01:49:04.212Z (5 months ago)
- Topics: beautiful-photos, beautiful-wallpapers, change-wallpaper, cli, download-photos, photography, photos, splash, unsplash, wallpaper, wallpapers
- Language: Go
- Homepage: http://splash-cli.app?ref=github
- Size: 57.3 MB
- Stars: 541
- Watchers: 10
- Forks: 28
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-cli-apps - splash-cli - Beautiful wallpapers from Unsplash. (Utilities / Theming and Customization)
- awesome-starred-test - rawnly/splash-cli - A simple, CLI to download Unsplash wallpapers. Nothing fancy — it just works. (Go)
README
# Splash CLI v4
[![Go](https://github.com/splash-cli/splash-cli/actions/workflows/go.yml/badge.svg?branch=go-rewrite)](https://github.com/splash-cli/splash-cli/actions/workflows/go.yml)
> Are you looking for the v3.x `splash-cli`? Check out the [master](https://github.com/splash-cli/splash-cli/tree/master) branchA 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
- [x] Change wallpaper on your desktop
- [x] Download photos
- [x] Login to your account
- [ ] Create new collections
- [ ] Add photos to collections
- [ ] Like photos
- More to come## Installation
#### Via Homebrew
```shell
brew tap rawnly/tap
brew install splash-cli
```#### Via Go
```shell
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](https://unsplash.com/developers).
Also remember that the BIN name will be `splash-cli` and not `splash`
#### Manually
- Download the [latest pre-release](https://github.com/splash-cli/splash-cli/releases)
- Move the binary to your `$PATH`
- Enjoy## Build Locally
To build the project locally you can use the following command:```shell
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](https://unsplash.com/developers).