A reverse-engineered reimplementation of Apple's AirPort Utility for macOS 27 and newer, using Swift frontend and Python backend.

Stars

11

7-day growth

No data

Forks

1

Open issues

0

License

MIT

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It fills a gap for modern macOS users who can no longer run Apple's official AirPort Utility, by providing an open-source alternative built with Codex assistance.

Who it is for

  • Mac users with legacy AirPort hardware
  • Developers interested in reverse-engineering Apple protocols
  • Network administrators managing AirPort base stations
  • Open-source contributors seeking a practical Swift/Python project

Use cases

  • Managing AirPort base station settings (e.g., network, disk, firmware)
  • Viewing network topology of connected AirPort devices
  • Configuring Internet settings including PPPoE (if hardware available)
  • Accessing AirPlay and NAS features on supported models

Strengths

  • Works with multiple AirPort Express, Extreme, and Time Capsule models
  • No third-party Swift or Python packages required
  • Includes both unit tests and live device integration tests
  • Actively welcomes contributions and bug reports

Considerations

  • Beta software with known bugs and some untested models
  • Cannot test features like PPPoE without necessary hardware
  • Requires macOS 13 or newer and Python 3.10+ to build and run

README quick start

AirPort Utility (beta)

Apple's AirPort Utility is not guaranteed to run on macOS 27 and newer, so I reverse engineered the application and have reimplemented it for macOS 27 and newer with Swift (front-end code) and Python (backend protocol code). I leveraged Codex to accelerate this work.

I have tested the app with the AirPort models below. However, bugs still remain and there are models I have not tested with. Even for devices that I have tested with, I cannot test all features, such as PPPoE, as I lack the necessary hardware. All contributions are welcome! Please open bug reports for any issues you find and pull requests are greatly appreciated!


Compilation

The build and runtime requirements are:

  • macOS 13 or newer
  • Swift 6.0 or newer, provided by Xcode 16 or newer or the corresponding Command Line Tools
  • Python 3.10 or newer available on PATH as python3

The project has no third-party Swift packages or Python packages to install. AppKit, SwiftUI, Security, Bonjour, and CommonCrypto are provided by macOS.

On a new Mac, install the Command Line Tools:

xcode-select --install

If python3 --version reports a version older than 3.10, install a newer Python. For example, with Homebrew:

brew install python

Verify that the required tools are selected:

swift --version
python3 --version

Then compile and run the application from the root of the repository:

./run.sh

Testing

Run the Swift unit tests from the root of the repository:

swift test

The default test run skips slower subprocess integration tests. Include them with:

AIRPORT_UTILITY_SLOW_TESTS=1 swift test

Run the Python backend unit tests separately:

python3 -m unittest Tests/BackendPythonTests/test_backend_modules.py

Live base-station tests are skipped unless their AIRPORT_LIVE_* environment flags are explicitly set. These tests can change network, password, disk, or firmware settings on real hardware and are not required for the normal test suite.


Recovered AirPort models

The app has been tested with these AirPort models. The app is still likely to work with AirPort models not listed, at least partially. The goal is to fully support all features of all models.

NameModelACP VersionDevice-Specific Features
AirPort ExpressA1088v1AirPlay

Description

Re-creation of Apple's AirPort Utility for macOS 27 and newer

Related repositories

Similar projects matched by category, topics, and programming language.

makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
simonw
Featured
simonw GitHub avatar

speech-analyzer-cli

A macOS command-line tool that uses Apple's on-device speech APIs to transcribe prerecorded audio into plain text, JSON, JSONL, SRT, or WebVTT.

Developer ToolsCLI & Terminal
20