Building from Source

Requirements

• Xcode 26+
• macOS 26.0+
• XcodeGen

Steps

git clone https://github.com/AlexTkDev/MacOSCleaner.git
cd MacOSCleaner
xcodegen generate
open MacOSCleaner.xcodeproj

Run the MacOSCleaner scheme. The app requires Full Disk Access to scan system paths.

Project Generation

The Xcode project is generated from project.yml (XcodeGen). Do not edit the .xcodeproj directly — edit project.yml and regenerate.

Build Script

A pre-build script (scripts/generate_cleanup_paths.swift) packs the private catalog:

• With engine_paths.json and ui_metadata.json present, they are packed and verified against the committed binary asset
• Without them, the committed fallback catalog is used

Regenerate the project after changing project.yml; the build script runs automatically as part of the scheme.

Code Signing

The app is signed with a development certificate for local builds; production builds use a Developer ID certificate and notarization. Adjust the signing configuration in project.yml for your own distribution.