Repository navigation
Releases
v1.0.1
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 infowallspan-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.appVerify what you downloaded:
shasum -c SHA256SUMS.txtv1.0.0
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 infowallspan-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.appVerify what you downloaded:
shasum -c SHA256SUMS.txtv1.0.0-beta.2
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 infowallspan-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.appVerify what you downloaded:
shasum -c SHA256SUMS.txtv1.0.0-beta.1
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 infowallspan-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.appVerify what you downloaded:
shasum -c SHA256SUMS.txtv0.1.0
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 wallpaperBezel 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.
cyclere-applies on Space switch so each
one catches up on arrival, but a one-shotapplyreaches only the Space you ran it from. - Only one
cycleruns at a time. A second exits immediately, naming the pid that holds
the lock. - The render cache never evicts. Safe to
rm -rfat 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 showprints 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 infowallspan-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.appNeither is signed or notarised, so Gatekeeper blocks them until the xattr lines above.
Verify what you downloaded:
shasum -c SHA256SUMS.txt