ipswnotes

Guide

ipswnotes compares each new iOS and macOS firmware package with the one before it and turns the differences into readable changelogs. This guide walks through the site from the first page you land on to the deepest level of detail.

1. The home page

On the home page of the app you can see the latest release and beta versions of firmware packages for tracked platforms, with a directory of all previous package versions since the project launched.

  • Latest releases shows the newest public version for each platform.
  • Latest betas shows betas and release candidates that are ahead of the current public version. When there are none, the column says so.
  • All releases lists every package tracked, newest first, so you can go back to any earlier version.

Click any version to open its page.

The home page with the latest releases, latest betas and the directory of all releases
The home page with the latest releases, latest betas and the directory of all releases

2. A firmware package's page

Each firmware package's page includes three written changelog reports, one per tab:

  • General focuses on the most important changes, the ones users will notice.
  • Security focuses on security changes. When Apple has published a security advisory for that release, the report compares what changed in the system with what Apple disclosed.
  • System changes goes into more detail on system-level changes: frameworks, daemons, entitlements and similar.

Long reports have an "On this page" outline for jumping between sections. The open tab is kept in the address bar (for example #security), so a link you share opens on the same tab.

The Security tab of iOS 27.2.1, cross-checking the changes against Apple's security advisory
The Security tab of iOS 27.2.1, cross-checking the changes against Apple's security advisory

Changelogs are written with AI assistance and may be inaccurate or miss some changes. The raw report below is the unedited source.

3. Changes Details

The Changes Details tab breaks the changes down into apps, frameworks and other components of the system, grouped into areas such as Safari & WebKit, Photos or Security. Each area shows how much changed in it.

Open an area to see its components (an app, framework or daemon) and inspect what kind of changes were made to each one: which files are new, removed or updated, and how many lines changed. From there you can open any item's diff.

The Changes Details tab with areas grouped by system part
The Changes Details tab with areas grouped by system part
One area opened, listing its components and the changes to each
One area opened, listing its components and the changes to each

4. The raw report

For deeper investigation, use the Raw report button next to the tabs. It opens a more detailed overview of the changes and change types across the different system components, with counts of new, removed and updated files in each section.

The sidebar holds the report's file tree. Browse it like folders on disk to open the changed files directly and read their diffs.

The raw report overview with change counts per section
The raw report overview with change counts per section
Browsing changed files in the raw report's sidebar
Browsing changed files in the raw report's sidebar

Another useful feature is instant full-text search across all diffs and all changelogs of every release. Type into the search box on the home page or in the header, or open the search page.

Once you have results you can narrow them down with the filters above them:

  • OS: iOS or macOS.
  • Release: one firmware package version.
  • Area: one part of the system, such as Safari & WebKit, or a whole group of areas.
  • Sources: the changelogs (General, Security, System changes) or the raw diffs only.

All the words you type must match. Put a phrase in quotes to match it exactly, and put a minus sign before a word to leave out results that contain it, for example "lock screen" -beta.

Search results filtered by OS and release
Search results filtered by OS and release

Building something?

Everything above is also available as JSON for scripts and AI agents. The For AI tab documents the API.