Skip to content

Releases: pepperstm/airport-utility

AirPort Utility 0.1.0 beta 4

Pre-release

Choose a tag to compare

@pepperstm pepperstm released this 23 Aug 06:05

Everything below has landed since 0.1.0 beta 3.

Highlights

  • Compare to... — a new "Compare to..." menu next to each Configuration History/Automatic Backup entry shows a field-by-field diff before you decide whether to restore: against the current live settings, or against any other visible entry from either store. Secrets are excluded from both sides identically, so a redacted stored password can never appear to "differ" from a real one.
  • Cleanup: removed a broken test file (test_trace_replay.py) that referenced two tools which never existed anywhere in this repo's history.
  • README refresh — a current Dashboard screenshot showing client identification, Configuration History, and Automatic Backups, alongside the existing topology and settings screenshots.

With this release, every feature from the original project vision plus both post-vision stretch goals (this diff view, and the extended two-entry compare) have shipped. Concurrent multi-site monitoring was considered and deliberately deferred — see the roadmap.

Install

  1. Download AirPort-Utility-0.1.0-beta.4-macos.zip.
  2. Verify its SHA-256 checksum if desired.
  3. Unzip it and move AirPort Utility.app to Applications.
  4. Open the app. Because this beta is ad-hoc signed rather than notarized, macOS may require you to Control-click the app, choose Open, and confirm the first launch.

Requirements

  • macOS 13 or newer, Apple Silicon
  • Network access to the AirPort base station and its administrator password
  • No system python3 required — the backend ships self-contained inside the app

See the README for full feature documentation and the roadmap for what's next.

AirPort Utility 0.1.0 beta 3

Pre-release

Choose a tag to compare

@pepperstm pepperstm released this 22 Aug 20:53

Everything below has landed since 0.1.0 beta 2. With this release, every feature from the original project vision has shipped.

Highlights

  • Sites — save a named connection (Home, Office, a parents' house) and switch back to it later, instead of waiting for Bonjour to rediscover it or retyping its address. Each site remembers a Bonjour stable identity (self-healing against DHCP address changes on the same network) and a last-known address as a fallback for reconnecting from elsewhere.
  • Recovery mode — when a restart, firmware install, or configuration write doesn't come back cleanly, a "Recovery" card on the Dashboard replaces the old bare status message with a clear next step: restore the most recent known-good settings (across Configuration History and Automatic Backups), or, as a last resort, the honest physical hard-reset procedure. This project has no access to a real recovery protocol, so it's a guided reaction to known failure points, not a new networking capability.
  • Fixed: Configuration History and Automatic Backups were showing every connected device's history mixed together in the Dashboard; both now correctly filter to the currently-connected host.

Install

  1. Download AirPort-Utility-0.1.0-beta.3-macos.zip.
  2. Verify its SHA-256 checksum if desired.
  3. Unzip it and move AirPort Utility.app to Applications.
  4. Open the app. Because this beta is ad-hoc signed rather than notarized, macOS may require you to Control-click the app, choose Open, and confirm the first launch.

Requirements

  • macOS 13 or newer, Apple Silicon
  • Network access to the AirPort base station and its administrator password
  • No system python3 required — the backend ships self-contained inside the app

See the README for full feature documentation and the roadmap for what's next.

AirPort Utility 0.1.0 beta 2

Pre-release

Choose a tag to compare

@pepperstm pepperstm released this 22 Aug 17:52

Everything below has landed since 0.1.0 beta 1.

Highlights

  • Network diagnostics — gateway, DNS, public-Internet, and likely double-NAT checks run from the Mac itself, independent of what the AirPort reports.
  • Wi-Fi congestion analysis — on-demand scan of nearby networks with channel recommendations, plus per-client SNR and Wi-Fi band in the Connected Clients details.
  • Configuration history and reviewed rollback — every settings write is snapshotted first; history records whether it completed and left the device reachable, with the option to restore.
  • Automatic configuration backups — a separate, credential-free settings snapshot saved about once a day just from connecting, independent of any change you make, so a recent backup exists before a firmware upgrade or factory reset.
  • Time Machine backup-history analysis — sparsebundle growth and backup-freshness assessment for Time Capsules.
  • Hardware compatibility reporting — Diagnostics shows whether a connected AirPort's product identifier matches a recognised profile, included in exported support bundles.
  • Client identification — a vendor name from a curated, real IEEE OUI lookup (never a guess), a conservatively-guessed device type, and an optional local nickname per client.
  • Detection of a base station outside this Mac's local network (VPN/remote access or a genuine double-NAT) with a clear Dashboard explanation instead of a silent "Not advertised" fallback.
  • Self-contained packaging — the Python backend now ships frozen inside the app; a system python3 is no longer required to run the packaged release, only to build it from source.
  • Dual licensing — most of the codebase stays MIT; a specific set of files that are new work by Graham Barber are separately released under GPLv3. See NOTICE.md.

Install

  1. Download AirPort-Utility-0.1.0-beta.2-macos.zip.
  2. Verify its SHA-256 checksum if desired.
  3. Unzip it and move AirPort Utility.app to Applications.
  4. Open the app. Because this beta is ad-hoc signed rather than notarized, macOS may require you to Control-click the app, choose Open, and confirm the first launch.

Requirements

  • macOS 13 or newer, Apple Silicon
  • Network access to the AirPort base station and its administrator password
  • No system python3 required — the backend now ships self-contained inside the app

See the README for full feature documentation and the roadmap for what's next.

AirPort Utility 0.1.0 beta 1

Pre-release

Choose a tag to compare

@pepperstm pepperstm released this 21 Aug 09:40

This is the first packaged beta of AirPort Utility Powerhouse, a modern SwiftUI reimplementation of AirPort Utility for recent macOS releases. It combines AirPort configuration with read-only network, client, Time Capsule, backup, and diagnostics monitoring.

Highlights

  • Live Dashboard and AirPort network topology
  • Automatic connection to the most upstream discovered AirPort at launch
  • Connected wireless-client signal, rate, PHY, and aggregate health reporting
  • Time Capsule capacity and SMART-status assessment
  • SMB reachability checks and mounted Time Machine backup freshness
  • Local health notifications for SMART, low space, SMB outages, and stale backups
  • Persistent 30-day trend charts backed by bounded 90-day local history
  • Structured redacted diagnostics and exportable support bundles
  • Standalone macOS app bundle with the Python backend included

Install

  1. Download AirPort-Utility-0.1.0-beta.1-macos.zip.
  2. Verify its SHA-256 checksum if desired.
  3. Unzip it and move AirPort Utility.app to Applications.
  4. Open the app. Because this beta is ad-hoc signed rather than notarized, macOS may require you to Control-click the app, choose Open, and confirm the first launch.

Requirements

  • macOS 13 or newer
  • Python 3.10 or newer available as python3
  • Network access to the AirPort base station
  • The base-station administrator password

Health-history privacy

Health history remains on the Mac. It stores aggregate measurements only and excludes client identities, MAC/IP addresses, Wi-Fi names, passwords, backup names, and backup paths. Samples are consolidated into 15-minute windows and bounded to 90 days or 2,000 records. History can be cleared from the Dashboard.

Known limitations

  • This is beta software and has not been tested with every AirPort model or configuration.
  • Client hostnames and IP addresses are shown only when devices or local discovery sources advertise them; the app does not fabricate identity data.
  • Time Machine backup inspection requires the relevant Time Capsule share to be mounted on the Mac.
  • PPPoE and some device-specific legacy features have limited real-hardware coverage.
  • The app is ad-hoc signed and not notarized.
  • Python 3 is not embedded in the app bundle.

Verification

  • GitHub CI passed the complete Swift test suite on the tagged commit.
  • All 76 Python backend tests passed.
  • The release app was built and signature-verified.
  • The packaged app passed an out-of-repository snapshot smoke test.

Integrity

SHA-256:

beea8cff1475347334a5cfd4b479fb25ff5f86cbdf56a2d6a0740b949c0f7525

See the included checksum asset for a machine-readable copy.