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 &amp; Helpers](/categories/utility)
4. /
5. pxgamer/splas-runner

ActiveLibrary[Utility &amp; 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 2w 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

2786d 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

[spatie/laravel-export

Create a static site bundle from a Laravel app

672139.5k6](/packages/spatie-laravel-export)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

5.1k4.9k](/packages/shlinkio-shlink)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

101466.4k45](/packages/friendsoftypo3-content-blocks)[aedart/athenaeum

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

245.2k](/packages/aedart-athenaeum)[eliashaeussler/typo3-solver

Solver - Extends TYPO3's exception handling with AI generated solutions. Problems can also be solved from command line. Several OpenAI parameters are configurable and prompts and solution providers can be customized as desired.

302.1k](/packages/eliashaeussler-typo3-solver)[aeliot/todo-registrar

Register TODOs from source code in issue tracker

153.0k](/packages/aeliot-todo-registrar)

PHPackages © 2026

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