PHPackages                             pxgamer/splas-runner - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. pxgamer/splas-runner

ActiveLibrary[Utility & Helpers](/categories/utility)

pxgamer/splas-runner
====================

A cross-platform binary to change the desktop background from Unsplash.

v4.1.1(7y ago)0281[1 issues](https://github.com/owenvoke/splas-runner/issues)MITPHPPHP ^7.1

Since Mar 7Pushed 7y ago1 watchersCompare

[ Source](https://github.com/owenvoke/splas-runner)[ Packagist](https://packagist.org/packages/pxgamer/splas-runner)[ RSS](/packages/pxgamer-splas-runner/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (7)Dependencies (7)Versions (27)Used By (0)

splas-runner
============

[](#splas-runner)

[![Latest Version on Packagist](https://camo.githubusercontent.com/712e3e90f12cd731dd3ac3cb3463317316bd10b5cb3448eebb95f09a17ee4c05/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f707867616d65722f73706c61732d72756e6e65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pxgamer/splas-runner)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/4e68596b4f4c25bfdd6bba6ffb561ef2f21e6e98ffaea7211aeef5455f3c37e1/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f707867616d65722f73706c61732d72756e6e65722f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/pxgamer/splas-runner)[![Style CI](https://camo.githubusercontent.com/9df676320f0ed8a24b113706710511820662df75e14e6d457cf9dbaaa0aa6cb9/68747470733a2f2f7374796c6563692e696f2f7265706f732f37363436313539302f736869656c64)](https://styleci.io/repos/76461590)[![Code Coverage](https://camo.githubusercontent.com/207205e056d59d8de92a049d56a5dc3e1a524a672e539853775bd3275932b721/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f707867616d65722f73706c61732d72756e6e65722e7376673f7374796c653d666c61742d737175617265)](https://codecov.io/gh/pxgamer/splas-runner)[![Total Downloads](https://camo.githubusercontent.com/d26ec98c0b7150151a00f9d08c4f2a33742f12228f8dabc7b6911026f72cedc3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f707867616d65722f73706c61732d72756e6e65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pxgamer/splas-runner)

A cross-platform binary to change the desktop background from [Unsplash](https://unsplash.com).
This package uses the [splas-php](https://github.com/pxgamer/splas-php) composer package.

Install
-------

[](#install)

Via Composer

```
$ composer global require pxgamer/splas-runner
```

Via Phive

```
$ phive install pxgamer/splas-runner
```

Usage
-----

[](#usage)

- Get an API key from [Unsplash](https://unsplash.com)
- Either set the `UNSPLASH_API_KEY` environment variable, or provide a `--key {key}` option in the command
- Run the binary using `splasr [options]`

#### Options

[](#options)

NameDescription--keep / -kSpecify whether to keep or remove images. Defaults to remove any images before downloading.--keySpecify your API key. Defaults to use the environment variable.--interval / -iSpecify an integer (minutes) when running in looped mode. By default will exit after the first run.#### Supported operating systems

[](#supported-operating-systems)

OSSupported?Windows✓Mac OSX✗Ubuntu✓Linux✗*Note: Running in an unsupported OS will result in an ErrorException.*

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Testing
-------

[](#testing)

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) and [CODE\_OF\_CONDUCT](CODE_OF_CONDUCT.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [pxgamer](https://github.com/pxgamer)
- [Unsplash](https://unsplash.com)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~25 days

Recently: every ~71 days

Total

25

Last Release

2832d ago

Major Versions

v1.0.0 → v2.0.02017-08-09

v2.1.0 → v3.0.02017-11-08

v3.3.0 → v4.0.02018-05-09

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1899334?v=4)[Owen Voke](/maintainers/owenvoke)[@owenvoke](https://github.com/owenvoke)

---

Top Contributors

[![owenvoke](https://avatars.githubusercontent.com/u/1899334?v=4)](https://github.com/owenvoke "owenvoke (181 commits)")

---

Tags

cross-platformdesktop-backgroundosphpphp-cron-runnersplas-phpunsplash-apiwallpaper

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/pxgamer-splas-runner/health.svg)

```
[![Health](https://phpackages.com/badges/pxgamer-splas-runner/health.svg)](https://phpackages.com/packages/pxgamer-splas-runner)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.9k556.2M21.3k](/packages/laravel-framework)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19467.3M1.9k](/packages/drupal-core)[spatie/laravel-export

Create a static site bundle from a Laravel app

679153.2k7](/packages/spatie-laravel-export)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)[lion/bundle

Lion-framework configuration and initialization package

132.4k5](/packages/lion-bundle)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)