Support

Xcode Build Ledger
macOS · Bundle ID com.xcodyssey.app
Local Xcode build time statistics

Xcode Build Ledger reads Xcode build activity logs on your Mac and shows daily waiting time, trends, project rankings, and recent build records. Data stays on your device by default. This page covers setup and common issues.

Getting started

Install Xcode Build Ledger from the Mac App Store.
Launch the app.
Open Settings (⌘,) from the sidebar footer.
Choose your DerivedData folder — typically:
```
~/Library/Developer/Xcode/DerivedData
```
Return to the main window and run Scan / refresh if needed.
If you have recent Xcode builds, the dashboard fills with today’s stats, trends, and rankings.

The app uses App Sandbox. It only reads folders you explicitly select through the macOS file picker and cannot browse your disk without permission.

System requirements

macOS 13 (Ventura) or later
Xcode with build activity logs (`.xcactivitylog`) in DerivedData
No account or internet connection required for core features

Troubleshooting

Dashboard is empty after scanning

Confirm the selected folder is the correct DerivedData directory, not a single project subfolder.
Build at least once in Xcode so new .xcactivitylog files are created.
In Settings, check options such as ignoring very short preview builds if you expect only full builds to count.
Re-open Settings and re-select the folder if macOS revoked folder access after an update.

“Access denied” or folder no longer readable

Sandbox apps rely on security-scoped bookmarks. If access breaks, open Settings and choose DerivedData again to restore permission.

Numbers look wrong or incomplete

Statistics are parsed from Xcode logs. Partial logs, parallel builds, or corrupted activity logs can affect totals. The app distinguishes waiting time from raw per-build duration where possible; see in-app Build insights for parse warnings.

App does not speed up builds

This is expected. Xcode Build Ledger is a measurement tool only. It does not modify Xcode projects, schemes, or compiler settings.

FAQ

Is my data uploaded?

No. By default, logs, paths, project names, and aggregated statistics remain on your Mac. See the Privacy Policy for details.

Do I need an account?

No. There is no sign-in.

Is this an official Apple or Xcode product?

No. “Xcode” is a trademark of Apple Inc. This app is not affiliated with Apple. It only reads standard Xcode build logs on your machine with your permission.

Which languages does the app support?

The Mac app supports multiple UI languages. You can change display language under Settings → General.

Where is data stored?

Aggregated events are saved locally (for example events.json in the app data directory). In App Store builds, data lives inside the app sandbox container. You can remove data by deleting those files or uninstalling the app.