Skip to content

Releases

v1.0.1

Choose a tag to compare

@github-actions github-actions released this 10 Nov 04:49
1752aeb

Features

  • app: Add an opt-out daily usage ping to Plausible (#51)

Full changelog: v1.0.0...1752aeb


Universal binary (arm64 + x86_64), macOS 14+. Signed with a Developer ID and
notarised by Apple.

tar -xzf wallspan-1.0.1-universal.tar.gz
cd wallspan-1.0.1-universal
./wallspan info

wallspan-1.0.1-universal is the same binary without the tarball, for an install script or a
formula. A downloaded file carries no executable bit, so it needs chmod +x.

A bare command-line binary cannot carry its notarisation ticket with it, so the
first time a downloaded copy runs, macOS checks with Apple online: run it once
with a network connection.

Wallspan.app is the menu bar app; it bundles the same CLI and prefers
whichever wallspan is on your PATH.

unzip Wallspan-1.0.1.zip
open Wallspan.app

Verify what you downloaded:

shasum -c SHA256SUMS.txt

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 13 Oct 19:24
3fc45e1

Features

  • ci: Pick the release version at dispatch, not in source (#49)
  • ci: Cut signed betas and publish them as wallspan@beta (#45)
  • ci: Sign and notarise release builds with Developer ID (#44)
  • app: Say where an installed CLI came from (#42)
  • app: Fall back to the bundled CLI when PATH's is newer (#41)
  • app: Draw the calibration pattern above every window (#38)
  • app: Draw the calibration lattice over the screens (#36)
  • app: Offer to check GitHub for a newer release (#34)
  • app: Give About its own window and fix Open at Login (#31)

Fixes

  • app: Time out a hung CLI call even if stdout stays open (#43)
  • cycle: Re-render the wallpaper when the layout is edited (#37)

Performance

  • cycle: Defer a scheduled change until the user is idle (#33)
  • cycle: Skip Spaces that already hold the wallpaper (#32)

Documentation

  • Lead the README with the menu bar app (#50)

Maintenance

  • release: Bump baseVersion to 1.0.0 so betas can be cut (#48)
  • app: Add WallspanAppTests and run them on every build (#40)
  • ci: Point the tap publish at serubin/tap (#25)

Full changelog: v0.1.0...3fc45e1


Universal binary (arm64 + x86_64), macOS 14+. Signed with a Developer ID and
notarised by Apple.

tar -xzf wallspan-1.0.0-universal.tar.gz
cd wallspan-1.0.0-universal
./wallspan info

wallspan-1.0.0-universal is the same binary without the tarball, for an install script or a
formula. A downloaded file carries no executable bit, so it needs chmod +x.

A bare command-line binary cannot carry its notarisation ticket with it, so the
first time a downloaded copy runs, macOS checks with Apple online: run it once
with a network connection.

Wallspan.app is the menu bar app; it bundles the same CLI and prefers
whichever wallspan is on your PATH.

unzip Wallspan-1.0.0.zip
open Wallspan.app

Verify what you downloaded:

shasum -c SHA256SUMS.txt

v1.0.0-beta.2

v1.0.0-beta.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 12 Oct 14:18
3d590f8

Beta. Install it, and later betas and releases, with
brew install --cask serubin/tap/wallspan@beta.

Features

  • ci: Pick the release version at dispatch, not in source (#49)
  • ci: Cut signed betas and publish them as wallspan@beta (#45)
  • ci: Sign and notarise release builds with Developer ID (#44)
  • app: Say where an installed CLI came from (#42)
  • app: Fall back to the bundled CLI when PATH's is newer (#41)
  • app: Draw the calibration pattern above every window (#38)
  • app: Draw the calibration lattice over the screens (#36)
  • app: Offer to check GitHub for a newer release (#34)
  • app: Give About its own window and fix Open at Login (#31)

Fixes

  • app: Time out a hung CLI call even if stdout stays open (#43)
  • cycle: Re-render the wallpaper when the layout is edited (#37)

Performance

  • cycle: Defer a scheduled change until the user is idle (#33)
  • cycle: Skip Spaces that already hold the wallpaper (#32)

Maintenance

  • release: Bump baseVersion to 1.0.0 so betas can be cut (#48)
  • app: Add WallspanAppTests and run them on every build (#40)
  • ci: Point the tap publish at serubin/tap (#25)

Full changelog: v0.1.0...3d590f8


Universal binary (arm64 + x86_64), macOS 14+. Signed with a Developer ID and
notarised by Apple.

tar -xzf wallspan-1.0.0-beta.2-universal.tar.gz
cd wallspan-1.0.0-beta.2-universal
./wallspan info

wallspan-1.0.0-beta.2-universal is the same binary without the tarball, for an install script or a
formula. A downloaded file carries no executable bit, so it needs chmod +x.

A bare command-line binary cannot carry its notarisation ticket with it, so the
first time a downloaded copy runs, macOS checks with Apple online: run it once
with a network connection.

Wallspan.app is the menu bar app; it bundles the same CLI and prefers
whichever wallspan is on your PATH.

unzip Wallspan-1.0.0-beta.2.zip
open Wallspan.app

Verify what you downloaded:

shasum -c SHA256SUMS.txt

v1.0.0-beta.1

v1.0.0-beta.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 12 Oct 03:51
2dac62a

Beta. Install it, and later betas and releases, with
brew install --cask serubin/tap/wallspan@beta.

Features

  • ci: Cut signed betas and publish them as wallspan@beta (#45)
  • ci: Sign and notarise release builds with Developer ID (#44)
  • app: Say where an installed CLI came from (#42)
  • app: Fall back to the bundled CLI when PATH's is newer (#41)
  • app: Draw the calibration pattern above every window (#38)
  • app: Draw the calibration lattice over the screens (#36)
  • app: Offer to check GitHub for a newer release (#34)
  • app: Give About its own window and fix Open at Login (#31)

Fixes

  • app: Time out a hung CLI call even if stdout stays open (#43)
  • cycle: Re-render the wallpaper when the layout is edited (#37)

Performance

  • cycle: Defer a scheduled change until the user is idle (#33)
  • cycle: Skip Spaces that already hold the wallpaper (#32)

Maintenance

  • release: Bump baseVersion to 1.0.0 so betas can be cut (#48)
  • app: Add WallspanAppTests and run them on every build (#40)
  • ci: Point the tap publish at serubin/tap (#25)

Full changelog: v0.1.0...2dac62a


Universal binary (arm64 + x86_64), macOS 14+. Signed with a Developer ID and
notarised by Apple.

tar -xzf wallspan-1.0.0-beta.1-universal.tar.gz
cd wallspan-1.0.0-beta.1-universal
./wallspan info

wallspan-1.0.0-beta.1-universal is the same binary without the tarball, for an install script or a
formula. A downloaded file carries no executable bit, so it needs chmod +x.

A bare command-line binary cannot carry its notarisation ticket with it, so the
first time a downloaded copy runs, macOS checks with Apple online: run it once
with a network connection.

Wallspan.app is the menu bar app; it bundles the same CLI and prefers
whichever wallspan is on your PATH.

unzip Wallspan-1.0.0-beta.1.zip
open Wallspan.app

Verify what you downloaded:

shasum -c SHA256SUMS.txt

v0.1.0

Choose a tag to compare

@github-actions github-actions released this 02 Sep 18:35
v0.1.0
635f905

First release.

wallspan applies one wallpaper across every display as a single continuous image, and
corrects for the physical facts macOS ignores: the bezels between your panels, and the
differing pixel densities of the panels themselves.

macOS only. No dependencies, no network access, no telemetry, no subscription.

wallspan info                                  # your displays, and how they're mapped
wallspan preview img.jpg -o out.png            # see the crop without touching anything
wallspan apply img.jpg                         # span it across every display
wallspan cycle ~/Pictures/Backgrounds --interval 15m
wallspan restore                               # back to your previous wallpaper

Bezel compensation

Monitors have bezels. macOS places displays edge to edge and gives you no way to describe
the gap, so content that should be hidden behind the bezels gets squeezed into view
instead — and a spanned image looks subtly wrong even though it is technically correct.

wallspan models each panel's active area in millimetres, so bezel gaps become real dead
space: content there is rendered and discarded, which is what makes the picture read as
continuous. wallspan calibrate puts a test pattern on your screens and you dial it in by
eye against the long diagonals — spotting a break in a straight line is a thing human
vision is unreasonably good at, far better than judging a gap width.

Cycling, and running unattended

wallspan cycle walks a folder on an interval. wallspan agent install moves that into a
LaunchAgent, so it survives closing the terminal and logging out, and re-applies your
wallpaper at each login. If the folder lives on a volume that is not mounted yet at login,
the agent waits rather than giving up.

Once something is cycling, you drive it without stopping it: status, next, pause,
resume. Pausing is a setting rather than a signal, so it survives a reboot and the agent
restarting; next works while paused and leaves it paused.

Settings live in a plain JSON file that a running agent re-reads within seconds, so
retuning the interval does not mean restarting anything.

The menu bar app

Wallspan.app is for people who would rather not use a terminal. It shows what is on
screen and when it changes next, and offers Next, Pause, a folder picker, an interval and
Restore.

It is a wrapper, not a second implementation — it spawns wallspan and reads its --json
output, and contains no wallpaper logic of its own. It prefers whichever wallspan is on
your PATH and falls back to the copy inside the bundle, so updating the CLI updates the
app's behaviour with no new app.

Displays ▸ Calibrate… does the bezel measurement without the terminal: arrow keys move
a panel in pixels, a scale control changes its density in PPI, and the gap readouts update
as you go. It pauses cycling while it is open and resumes when you close it — unless you
had already paused it yourself.

Known limits

  • macOS keeps a separate wallpaper per Space. cycle re-applies on Space switch so each
    one catches up on arrival, but a one-shot apply reaches only the Space you ran it from.
  • Only one cycle runs at a time. A second exits immediately, naming the pid that holds
    the lock.
  • The render cache never evicts. Safe to rm -rf at any time.
  • Content that falls outside any panel — behind bezels, above or below a shorter screen —
    is discarded. With an ultrawide beside a portrait panel that can be roughly a third of
    the source; wallspan layout show prints the figure.

GPL-3.0-or-later. No code was taken from any existing product.


Universal binary (arm64 + x86_64), macOS 14+.

tar -xzf wallspan-0.1.0-universal.tar.gz
cd wallspan-0.1.0-universal
xattr -c wallspan   # unsigned: macOS quarantines downloads
./wallspan info

wallspan-0.1.0-universal is the same binary without the tarball, for an install script or
a formula. A downloaded file carries no executable bit, so it needs chmod +x.

Wallspan.app is the menu bar app; it bundles the same CLI and prefers whichever
wallspan is on your PATH.

unzip Wallspan-0.1.0.zip
xattr -dr com.apple.quarantine Wallspan.app
open Wallspan.app

Neither is signed or notarised, so Gatekeeper blocks them until the xattr lines above.

Verify what you downloaded:

shasum -c SHA256SUMS.txt