Repository Public License
1<!-- ORIX Clean / File: README.md / Author: Simon-Pierre Boucher / Contact: contact@spboucher.ai -->2<div align="center">34<img src="docs/assets/icon.png" width="168" alt="ORIX Clean icon: a storage ring with one quarter swept clean">56# ORIX Clean78### Reclaim Space. Keep Control.910**A native macOS storage analyzer and cleanup utility that measures everything it shows,<br>explains everything it proposes, and removes nothing without your confirmation.**1112**Author: Simon-Pierre Boucher** · part of the **ORIX** family of Apple utilities1314151617181920212223-6366F1?style=flat-square)242526272829303132333435363738-06B6D4?style=flat-square)3940    4142**[Download ORIX Clean 1.0.0 (DMG, 5.1 MB)](https://git.spboucher.ai/releases/orix-clean/v1.0.0/ORIXClean-1.0.0.dmg)** · [ZIP](https://git.spboucher.ai/releases/orix-clean/v1.0.0/ORIXClean-1.0.0.zip) · [SHA-256](https://git.spboucher.ai/releases/orix-clean/v1.0.0/SHA256SUMS.txt) · [All releases](https://git.spboucher.ai/orix-clean/releases)4344<br>4546<img src="docs/screenshots/02-storage-map.png" width="100%" alt="ORIX Clean storage map: a treemap of a home folder with a list of its folders beside it">4748<sub>The storage map on the sample home folder. Every block is a real file or folder, sized by its measured size on disk.</sub>4950</div>5152> **About the screenshots.** They are captures of the real application (window captured by its window ID) running on a **generated sample home folder** of 182 real files (1.89 GB) written by `orix-bench fixture`, so that no personal file name appears here. Sizes, duplicate groups, similar-image groups and cleanup results are what the engines measured on those files. The History screenshot shows real free-space samples of the development Mac.5354---5556## Contents57581. [Overview](#1-overview) · 2. [Product Philosophy](#2-product-philosophy) · 3. [Application Preview](#3-application-preview) · 4. [Storage Analysis](#4-storage-analysis) · 5. [Interactive Storage Map](#5-interactive-storage-map) · 6. [Large Files](#6-large-files) · 7. [Duplicate Detection](#7-duplicate-detection) · 8. [Similar Images](#8-similar-images) · 9. [Cache Cleanup](#9-cache-cleanup) · 10. [Uninstall Assistant](#10-uninstall-assistant) · 11. [Leftover Files](#11-leftover-files) · 12. [Developer Cleanup](#12-developer-cleanup) · 13. [Downloads Cleanup](#13-downloads-cleanup) · 14. [Trash Analysis](#14-trash-analysis) · 15. [Cleanup Preview](#15-cleanup-preview) · 16. [Safe Deletion](#16-safe-deletion) · 17. [Storage Intelligence](#17-storage-intelligence) · 18. [Storage History](#18-storage-history) · 19. [ORIX Clean Actions](#19-orix-clean-actions) · 20. [Reports](#20-reports) · 21. [Filesystem Architecture](#21-filesystem-architecture) · 22. [APFS Considerations](#22-apfs-considerations) · 23. [Technology Stack](#23-technology-stack) · 24. [Installation](#24-installation) · 25. [Build Instructions](#25-build-instructions) · 26. [Testing](#26-testing) · 27. [Benchmarks](#27-benchmarks) · 28. [Privacy](#28-privacy) · 29. [Accessibility](#29-accessibility) · 30. [Localization](#30-localization) · 31. [Roadmap](#31-roadmap) · 32. [Release Status](#32-release-status) · 33. [Known Limitations](#33-known-limitations) · 34. [ORIX Ecosystem](#34-orix-ecosystem) · 35. [License](#35-license)5960---6162## 1. Overview6364ORIX Clean answers three questions about a Mac's storage, in this order:65661. **Where did the space go?** A parallel scanner reads names and sizes straight from the filesystem and draws them as an interactive treemap.672. **What could be removed, and what happens if it is?** Duplicates, similar pictures, caches, developer data, old downloads, applications and their files — each candidate comes with a reason, a risk level and a consequence.683. **Do you really want that?** Every removal passes through a preview that lists the exact items. They go to the Trash, per-item outcomes are recorded, and they can be put back.6970| | |71|---|---|72| **Platform** | macOS 15.0 or later, universal binary (built and run on macOS 27.0, Apple M5 Max) |73| **Language / UI** | Swift 6 (strict concurrency), SwiftUI + AppKit, Swift Charts, Canvas |74| **Core** | `ORIXCleanCore`, a UI-free Swift package: 19 files, 3,573 lines, 56 tests |75| **App** | 18 Swift files, 3,352 lines; 684 localized strings (English, Canadian French) |76| **Dependencies** | None. No third-party package, no network code, no helper tool |77| **Bundle identifier** | `ai.spboucher.orix.clean` |78| **Distribution** | Developer ID signed, Hardened Runtime, Apple notarization, DMG + ZIP |7980## 2. Product Philosophy8182| Principle | What it means in the code |83|---|---|84| **Every number is measured** | Sizes come from `getattrlistbulk(2)` during the scan. Nothing is derived from file names, and there is no simulated progress: counters shown during a scan are the scanner's own counters. |85| **Honest savings** | Recoverable space is a **range** when APFS reports shared blocks: from the sum of private sizes to the sum of allocated sizes. Hard links are reported as freeing nothing. |86| **No automatic cleanup** | Nothing is preselected in duplicates or similar images. A `CleanupAuthorization` can only be built from the plan the user confirmed; the engine skips anything else. |87| **Reasons, not fear** | Each candidate states why it is listed, what happens if it is removed and what it costs to get back. There are no urgency banners and no "your Mac is at risk" language. |88| **Nothing leaves the Mac** | No account, no analytics, no update check. `Scripts/check.sh` fails the build if networking APIs appear in the product sources. |89| **Supported APIs only** | No private API, no privileged helper, no administrator prompt, no attempt to get around System Integrity Protection or privacy controls. What cannot be read is reported as not read. |9091## 3. Application Preview9293<table>94<tr>95<td width="50%"><img src="docs/screenshots/01-overview.png" alt="Overview"><br><sub><b>Overview.</b> Volumes as macOS reports them, the measured breakdown by type, and recommendations that quote their evidence.</sub></td>96<td width="50%"><img src="docs/screenshots/14-light-mode.png" alt="Overview in light mode"><br><sub><b>Light mode.</b> The same screen with the light palette; appearance follows the system or the setting.</sub></td>97</tr>98<tr>99<td><img src="docs/screenshots/02-storage-map.png" alt="Storage map, dark"><br><sub><b>Storage map, dark.</b> Folders are frames, files are blocks coloured by type.</sub></td>100<td><img src="docs/screenshots/15-storage-map-light.png" alt="Storage map, light"><br><sub><b>Storage map, light.</b></sub></td>101</tr>102</table>103104## 4. Storage Analysis105106The scanner walks a folder or a volume with a small pool of threads. Each directory is read in one or a few system calls that return, for every entry, its name, type, device, modification date, link count, **content size**, **allocated size** and — on APFS — **private size**, clone identifier and sharing flags.107108- **Three sizes, never mixed.** *Content size* is the length of the files. *Size on disk* is what is allocated. *Private size* is what APFS says would come back if that file alone were removed.109- **Accuracy check.** On a 31,259-object tree the allocated total equals `du -sk` to the byte (`2,412,920,832`); a test repeats this comparison on every run.110- **Never follows symbolic links.** Mount points and other devices are boundaries; a volume mounted inside the scanned folder is detected from the opened directory itself.111- **Hard links are counted once.** Other names of the same file are kept in the tree but add nothing to totals.112- **Cloud-only files are never opened.** Items whose content is not on the Mac (`SF_DATALESS`) are flagged; hashing or previewing them would download them.113- **Cancellable and pausable**, with live counters. Unreadable folders are listed as issues, and the totals say what is missing.114- **Startup volume.** Scanning `/` enters the Data volume through its firmlinks and skips `/System/Volumes`, so nothing is counted twice.115116## 5. Interactive Storage Map117118<img src="docs/screenshots/19-french-canadian.png" width="100%" alt="Storage map in Canadian French">119<sub>The map with the interface in Canadian French. Number and unit formats follow the locale.</sub>120121- **Squarified treemap** drawn in a SwiftUI `Canvas`: area is proportional to measured size within each folder.122- **Level of detail.** Only regions large enough to see are laid out; siblings that would be under a few square points are merged into one cell labelled "*N* smaller items" with their real combined size. Laying out a 467,907-node tree takes 0.16 ms.123- **Interactions.** Double-click to drill down, breadcrumb to go back up, pinch to zoom (up to 12×), drag to pan, hover for details, right-click for *Reveal in Finder*, *Quick Look*, *Copy Path* and *Add to Cleanup Selection*.124- **Search** dims everything that does not match and lists the matches.125- **Two size modes** (on disk / content) and **two palettes** (ORIX, and the Okabe–Ito colour-blind-safe set).126- **A list beside the map** shows the same data sorted by size; it is the keyboard and VoiceOver path through the tree.127128## 6. Large Files129130<img src="docs/screenshots/03-large-files.png" width="100%" alt="Large files list with filters">131132Largest files or largest folders, filtered by minimum size, age, type, name and whether to look inside packages. The age filter uses the modification date and says so: *not modified* is not *not used*. When Spotlight has recorded a last-opened date for a file, it is shown next to it as additional evidence; ORIX Clean never claims a file is unused.133134## 7. Duplicate Detection135136<img src="docs/screenshots/04-duplicates.png" width="100%" alt="Duplicate groups with one copy kept per group">137<sub>Four groups found in the sample. In the second, both files are APFS clones: the app says they share storage, and the selection bar gives the recoverable space as a range.</sub>138139```mermaid140flowchart LR141 A[Regular files in the scan] --> B[Group by content size]142 B --> C[Sampled SHA-256: head, middle, tail]143 C --> D[Full SHA-256, streamed]144 D --> E[Groups of identical digests]145 E --> F[You choose the copy to keep]146 F --> G[Byte-for-byte check against the kept copy]147 G --> H[Move to Trash]148```149150- The sampled hash only narrows candidates; **the full hash decides**. A test forces every sampled hash to collide and checks that no false group appears.151- A file whose size no longer matches the scan is dropped rather than compared.152- **Hard links** are one file under several names: not offered, because removing a name frees nothing.153- **APFS clones** are real duplicates that share blocks: flagged, with a recoverable range instead of a single figure.154- Files inside applications, photo libraries and other packages are skipped unless asked for.155- **One copy always stays.** The UI refuses to tick the last copy, and the deletion engine independently refuses to remove a duplicate whose kept copy is missing, selected, different, or the same inode.156157## 8. Similar Images158159<img src="docs/screenshots/05-similar-images.png" width="100%" alt="Groups of similar images with confidence">160161Two measurements are combined, both computed on the Mac: a 64-bit **difference hash** (structure) and a **Vision feature print** (appearance). Images whose structure is nearly identical (4 bits or fewer of 64) are grouped on structure alone; beyond that, Vision must agree. A *fast* mode compares structure first; a *thorough* mode compares every pair and also finds crops (limited to 3,000 images). Groups are built around a representative image, so a chain of "A resembles B, B resembles C" does not put A and C together. The confidence shown is the weakest link of the group. **Nothing is preselected**, and at least one image per group must stay.162163## 9. Cache Cleanup164165<img src="docs/screenshots/06-cache-cleanup.png" width="100%" alt="Caches and logs with risk badges and a selection bar">166167A documented catalogue of 35 locations (12 for caches and logs, 23 for developer tools): application caches in `~/Library/Caches`, web caches of eight browsers (the cache folder only — never the profile, history, cookies or passwords), logs, crash reports and old temporary items.168169- **Not listed, on purpose:** Apple system caches (`com.apple.*`) and caches known to hold state (CloudKit, HomeKit, and others in an explicit exclusion list).170- Every row gives *why it is listed*, *what happens if you remove it*, *how you get it back*, and the estimated recoverable space.171- If the owning application is running, the row says so and the engine leaves the item in place.172- **No performance promise.** The screen states that removing caches does not make a Mac faster and that applications will use part of the space again.173174## 10. Uninstall Assistant175176<img src="docs/screenshots/07-uninstall-assistant.png" width="100%" alt="Application detail with signature information and associated files">177178For each installed application: size, version, bundle identifier, who signed it (read from the static code signature, without running it), team identifier and the last-used date Spotlight recorded. Associated files are searched in twelve Library locations and labelled by certainty:179180| Certainty | Rule | Risk |181|---|---|---|182| Matches the bundle identifier | Named exactly after the identifier (or a helper identifier that extends it) | Review required |183| Shared by the developer's apps | Group container keyed by the team identifier | High — never preselected |184| Name match only | Named after the application's display name | High — never preselected |185186Documents are never part of an uninstall. Applications that ship with macOS are shown but cannot be selected.187188## 11. Leftover Files189190Library items named after an application identifier for which no installed application is found (by the scan of the application folders and by Launch Services). The screen says plainly that this is an **inference from names**: command-line tools, plug-ins and applications on other volumes can look like leftovers. Items sharing a vendor prefix with an installed application are not flagged. Everything is *review required*.191192## 12. Developer Cleanup193194<img src="docs/screenshots/08-developer-cleanup.png" width="100%" alt="Developer cleanup lab grouped by tool">195196Xcode DerivedData (one row per project), archives (marked *review*: they hold the dSYMs of shipped builds), device support files, simulator caches, and the caches of Swift Package Manager, CocoaPods, Carthage, Homebrew, npm, Yarn, pnpm, pip, uv, Gradle, Maven, Cargo, Go and Playwright. After a scan, build folders (`node_modules`, `.build`, `target`…) are listed only when they sit next to their project manifest.197198**Reported but never removed:** simulator devices, simulator runtimes and the Docker disk image, each with the supported command or menu to clean it.199200## 13. Downloads Cleanup201202<img src="docs/screenshots/16-downloads.png" width="100%" alt="Downloads grouped into installers, disk images, archives and incomplete downloads">203204Installers, disk images, archives and incomplete browser downloads, with the date each arrived in the folder. An archive that sits next to an item of the same name is noted as "may be already extracted (not verified)". Everything here is *review required*.205206## 14. Trash Analysis207208<img src="docs/screenshots/17-trash.png" width="100%" alt="Trash content with sizes">209210Size and content of the Trash of the home folder and of each mounted volume. Reading the Trash requires Full Disk Access; without it the screen says the content is unknown instead of showing zero. Emptying is the only permanent deletion in the application: it has its own confirmation that requires typing `DELETE`.211212## 15. Cleanup Preview213214<img src="docs/screenshots/09-cleanup-preview.png" width="100%" alt="Cleanup preview listing every selected item with reason and consequence">215216No removal can start anywhere else. The preview shows every path, grouped by risk, with its reason and consequence, the content size, the estimated recoverable space and the recovery option. Items can be unticked there. High-risk items require a separate acknowledgement.217218## 16. Safe Deletion219220<img src="docs/screenshots/10-cleanup-results.png" width="100%" alt="Cleanup results with per-item outcome and Put Back buttons">221<sub>Result of a real cleanup of the sample caches. The app states that the space is still occupied until the Trash is emptied.</sub>222223```mermaid224flowchart TD225 P[Confirmed plan + authorization] --> A{Path in the confirmed set?}226 A -- no --> S1[Skipped]227 A -- yes --> B{Safety policy allows it?}228 B -- no --> S2[Skipped: protected]229 B -- yes --> C{Still there, same file, same size?}230 C -- no --> S3[Skipped: changed since the scan]231 C -- yes --> D{Owning app running?}232 D -- yes --> M[Requires manual action]233 D -- no --> E{Duplicate: identical to the kept copy?}234 E -- no --> S4[Skipped]235 E -- yes --> T[Move to Trash]236 T -- ok --> R1[Moved to Trash, location recorded]237 T -- no Trash on volume --> M238 T -- error --> F[Failed, with the system's reason]239```240241- **Five outcomes**, never merged: *Moved to Trash*, *Permanently deleted*, *Skipped*, *Failed*, *Requires manual action*.242- **A last line of defence** (`SafetyPolicy`) refuses system areas, standard folders themselves, volume roots, the inside of application bundles and of photo, music and video library packages — whatever asked.243- **Put Back** restores an item while it is still in the Trash, and refuses to overwrite anything that now occupies the original place.244- A volume without a Trash yields *Requires manual action*; the engine never falls back to permanent deletion.245246## 17. Storage Intelligence247248Recommendations are computed only from data that has actually been analysed; an analysis that has not run produces none. Each one carries its evidence (counts, measured sizes, paths), a risk level, the consequence and a link to the relevant screen. Thresholds are constants in `RecommendationEngine`. A growth projection is offered only with at least three samples over six hours, and is labelled a projection.249250## 18. Storage History251252<img src="docs/screenshots/11-storage-history.png" width="100%" alt="Used space over time from recorded samples">253254Free-space samples of each volume (every 15 minutes while the application is open, and after each scan and cleanup), sizes of watched folders, and the log of every cleanup with its per-item outcome. The chart starts at the first recorded sample and the screen says that nothing exists before it.255256## 19. ORIX Clean Actions257258<img src="docs/screenshots/18-actions.png" width="100%" alt="Reusable cleanup workflows">259260Reusable sequences of real operations: scan, find duplicates, collect caches, developer data or old downloads, **review**, move to Trash, report. A workflow is rejected at save time and at run time unless every removal step comes directly after a review step, and that review is the same preview sheet. Declining it ends the run with nothing removed.261262## 20. Reports263264<img src="docs/screenshots/12-reports.png" width="100%" alt="Report generator with a Markdown preview">265266Nine report types (storage overview, largest files, duplicates, similar images, caches, developer data, application uninstall, cleanup results, storage trends) exported as **PDF, CSV, JSON or Markdown**. Each includes the scan date and scope, what could not be read, measured sizes, estimated recoverable space and actual results. CSV cells that start with a formula character are neutralised.267268## 21. Filesystem Architecture269270```mermaid271flowchart LR272 subgraph App[SwiftUI application]273 V[Views] --> M[AppModel]274 end275 subgraph Core[ORIXCleanCore - no UI]276 SC[FileScanner] --> T[(ScanTree arena)]277 T --> Q[Queries + Treemap]278 T --> D[DuplicateFinder]279 T --> I[SimilarImageFinder]280 CAT[CleanupCatalog] --> PL[CleanupPlan]281 D --> PL282 I --> PL283 Q --> PL284 PL --> AU[CleanupAuthorization]285 AU --> DE[DeletionEngine]286 SP[SafetyPolicy] --> DE287 DE --> RP[DeletionReport]288 RP --> H[(HistoryStore SQLite)]289 RP --> R[Report: PDF CSV JSON MD]290 end291 M --> SC292 M --> CAT293 M --> DE294 FS[(Filesystem)] --> SC295 DE --> TR[(Trash)]296```297298The scan result is an arena of fixed 64-byte records (parent, children range, flags, three sizes, date, file id) plus one name buffer — about 125–160 bytes per object in practice. Children always follow their parent, so directory totals are one reverse pass. Details: [`docs/architecture/`](docs/architecture/overview.md).299300```mermaid301sequenceDiagram302 participant U as User303 participant A as App304 participant S as Scanner threads305 participant K as Kernel306 U->>A: Scan folder307 A->>S: start(root)308 loop each directory309 S->>K: open(O_NOFOLLOW) + fstat310 K-->>S: device (boundary check)311 S->>K: getattrlistbulk312 K-->>S: names, types, sizes, sharing flags313 S->>S: append records under lock314 end315 A-->>U: live counters (10 per second)316 S->>A: tree + issues317```318319## 22. APFS Considerations320321| Situation | What ORIX Clean does |322|---|---|323| **Clones** (`cp -c`, Finder duplicates) | Both files show their full allocated size; the private size shows what removal would really free. Recoverable space is given as a range. |324| **Hard links** | Counted once in totals; never offered as duplicates. |325| **Sparse files** | Content size and size on disk are both shown; the map can use either. |326| **Transparent compression** | Allocated size reflects the compressed size; flagged in the tree. |327| **Local snapshots** (Time Machine, updates) | Not enumerated. Data removed today can stay on disk until the snapshot expires — stated in every report. |328| **Purgeable space** | The figure macOS reports is shown separately on the Overview; ORIX Clean does not claim it. |329| **Cloud-only files** | Counted as zero on disk, never read. |330| **Trash** | Moving to the Trash frees nothing until the Trash is emptied — stated in the preview and in the results. |331332## 23. Technology Stack333334| Area | Technology |335|---|---|336| Language | Swift 6, strict concurrency, `MainActor` default isolation in the app |337| UI | SwiftUI, AppKit (panels, Quick Look, workspace), Swift Charts, `Canvas` |338| Filesystem | `getattrlistbulk`, `getattrlist`, `clonefile` (tests), `FileManager.trashItem` |339| Hashing | CryptoKit SHA-256, `F_NOCACHE` streaming reads |340| Images | ImageIO thumbnails, Vision feature prints, Accelerate |341| Signatures | Security framework (`SecStaticCode`) |342| Persistence | SQLite (C API), WAL |343| Reports | Core Text / Core Graphics PDF, Codable JSON |344| Project | XcodeGen, Swift Package Manager, Swift Testing, XCUITest |345346Decisions and their reasons (Canvas rather than Metal, SQLite rather than SwiftData, no updater, no helper) are recorded in [`docs/architecture/overview.md`](docs/architecture/overview.md).347348## 24. Installation3493501. Download [`ORIXClean-1.0.0.dmg`](https://git.spboucher.ai/releases/orix-clean/v1.0.0/ORIXClean-1.0.0.dmg).3512. Check it: `shasum -a 256 ORIXClean-1.0.0.dmg` must match `SHA256SUMS.txt`.3523. Open the disk image and drag **ORIX Clean** to **Applications**.3534. Optional: System Settings › Privacy & Security › Full Disk Access › enable ORIX Clean, to include protected folders and the Trash.354355## 25. Build Instructions356357```bash358brew install xcodegen create-dmg # project generator, DMG builder359Scripts/build.sh generate # strings catalogue + Xcode project360Scripts/build.sh core-test # 56 engine tests (swift test)361Scripts/build.sh debug # Debug build362Scripts/build.sh uitest # 8 UI scenarios on a disposable disk image363Scripts/sign.sh # Release, universal, Developer ID, Hardened Runtime364Scripts/notarize.sh # Apple notarization + stapling (existing keychain profile)365Scripts/package.sh && Scripts/notarize.sh dist/ORIXClean-1.0.0.dmg dmg && Scripts/finalize.sh366```367368Requirements: Xcode 27 (Swift 6.2 or later for default actor isolation), macOS 15 SDK or later. More in [`docs/development/setup.md`](docs/development/setup.md).369370## 26. Testing371372| Suite | Tests | What it proves |373|---|---|---|374| Scanner | 16 | Totals equal the kernel's and `du`; Unicode and 1,500-byte paths; symlink loops; hard links; APFS clones; sparse files; permission denied; files changing during 25 scans; 32,000 files; packages; cancel and pause; mounted volume boundary and removal |375| Treemap | 1 | Areas proportional, inside the parent, no overlap, honest aggregate cell, viewport culling |376| Duplicates | 9 | Exact groups and digest equal to `shasum`; a one-byte difference outside the sampled windows; forced sample collisions; hard links; clones; 48 MB files; unreadable and changed files; packages; cancellation |377| Similar images | 3 | Resized, recompressed and PNG copies grouped; unrelated images not grouped; crops in thorough mode; corrupt images counted |378| Safety policy | 2 | 39 protected paths refused, 13 ordinary paths allowed |379| Deletion | 11 | No removal without authorization; high-risk acknowledgement; real Trash and Put Back; no overwrite on restore; vanished, replaced and changed items; duplicate verification; a group is never emptied; partial failure; running applications; read-only and full volumes |380| Catalogue, downloads, Trash | 6 | Only documented locations; exclusions; every rule documented; build folders need their manifest |381| Applications | 3 | Discovery, associated files by certainty, system apps never offered, conservative leftovers |382| History, reports | 3 | SQLite round trip, trend, recommendations only from evidence, four renderers, CSV formula neutralisation |383| Workflows | 2 | Removal without review is invalid; a declined review removes nothing |384| **UI (XCUITest)** | 8 | First launch; scan, map and search; large files; duplicates; similar images; caches, developer, downloads, Trash; uninstall preview → cancel → real cleanup → Put Back; report export; declined action; light mode, settings, window sizes |385386Destructive tests run only on temporary directories and on disk images created for the test. Core line coverage: **86.7 %** (2,662 of 3,070 lines). Details: [`docs/development/testing.md`](docs/development/testing.md).387388## 27. Benchmarks389390Measured on 2026-11-21, MacBook Pro (Mac17,6, Apple M5 Max, 48 GB), macOS 27.0, internal APFS SSD, release build, warm file cache. Reproduce with `orix-bench`.391392| Measurement | Result |393|---|---|394| Scan `~/Library/Developer` — 985,558 files, 699,525 folders | 17.4 s · 96,757 objects/s · 202 MB peak memory |395| Scan `/Applications` — 448,727 files, 64,278 folders, 3 threads | 3.04 s · 168,644 objects/s · 8.9 CPU-s · 77 MB |396| Same, 1 thread / 8 threads | 3.45 s, 3.4 CPU-s / 4.07 s, 23.4 CPU-s |397| Treemap layout, 467,907 nodes at 1600×1000 | 0.16 ms → 1,798 cells |398| Duplicate search, sample folder (685 MB hashed) | 0.07 s (warm cache; cold reads are bound by the disk) |399| Similar images, sample folder (31 images, fast mode) | 0.21 s |400| Signed application size | 13 MB (universal) |401402Directory enumeration is bound by the filesystem rather than by cores, which is why the default is three threads (one in Low Power Mode or under thermal pressure). Method and raw numbers: [`docs/development/performance.md`](docs/development/performance.md).403404## 28. Privacy405406- No account, no network code, no analytics, no advertising, no update check.407- A scan reads names and metadata. File contents are read only for the analyses you start (hashing, image fingerprints), and stay in memory.408- Stored locally in `~/Library/Application Support/ORIX Clean/history.sqlite`: volume samples, watched-folder sizes, cleanup logs, saved actions. *Settings › Privacy & Access › Erase History* removes them.409- macOS asks before the app reads Desktop, Documents, Downloads, removable or network volumes. Full Disk Access is optional and never requested by a prompt of ours.410411<img src="docs/screenshots/13-settings.png" width="60%" alt="Settings window">412413More: [`docs/PRIVACY.md`](docs/PRIVACY.md).414415## 29. Accessibility416417VoiceOver labels on controls and rows, full keyboard navigation (`⌘1`–`⌘9` sections, `⌘O` scan, `⌘↩` review), a list equivalent of the treemap, a colour-blind-safe map palette, risk levels that differ by shape as well as colour, respect for Reduce Motion, and a compact density for the Large Files list. **Not verified:** no session with a VoiceOver user and no instrumented contrast measurement — see [`docs/ACCESSIBILITY.md`](docs/ACCESSIBILITY.md).418419## 30. Localization420421English and Canadian French (684 strings). Sizes, numbers and dates are formatted for the locale. Known gap: strings have no plural variants yet, so "1 items" / « 1 éléments » can appear.422423## 31. Roadmap424425- Plural-aware strings.426- A Finder-sync or Services entry point ("Analyze with ORIX Clean").427- Background sampling (login item) so history does not depend on the app being open.428- Signed automatic updates, if a way is found that keeps the "no network code by default" promise.429- Sunburst as an alternative view of the map.430- An Icon Composer layered icon for macOS 26 and later.431432## 32. Release Status433434| Item | Status (2026-11-21) |435|---|---|436| Version | 1.0.0, build 1 |437| Source repository | Public since 2026-11-21 at the owner's request: <https://git.spboucher.ai/orix-clean> (`gitsrv:srv/git/orix-clean.git`) |438| Developer ID signature | Valid — `Developer ID Application: Simon-Pierre Boucher (3YM54G49SN)`, Hardened Runtime, secure timestamp, no entitlements |439| Apple notarization — app | **Accepted**, submission `c2e7cbaa-9410-466f-b912-b9666f5a02b7`, ticket stapled |440| Apple notarization — DMG | **Accepted**, submission `ff776146-c989-45d6-99de-c93bb217d8c1`, ticket stapled |441| Gatekeeper | `accepted`, source *Notarized Developer ID*, for the app, the DMG and the app extracted from the ZIP |442| `ORIXClean-1.0.0.dmg` | 5,133,225 bytes · SHA-256 `c7a8b13f3db143e80d2902882d8fe069d68b6e89a1de212411dffdb7334bcd34` |443| `ORIXClean-1.0.0.zip` | 4,032,161 bytes · SHA-256 `126a980dd974136fc958ff7ab9a9b735d68aa2cc162d2729fa4f7d55a03da9fd` |444| SPB Git release | **Published**: <https://git.spboucher.ai/orix-clean/releases> — tag `v1.0.0`; DMG, ZIP and `SHA256SUMS.txt` under `https://git.spboucher.ai/releases/orix-clean/v1.0.0/` |445| Download verification | The three files were downloaded back from the forge: sizes and SHA-256 match, the DMG's stapled ticket validates and Gatekeeper answers `accepted` |446| README rendering on SPB Git | Checked from the served page: 12 Mermaid blocks present, all 20 local images served (HTTP 200). Not looked at in a browser. |447448Full detail: [`RELEASE-REPORT.md`](RELEASE-REPORT.md).449450## 33. Known Limitations451452- **Tested on one configuration only**: macOS 27.0 on Apple Silicon. Built for macOS 15.0+ and as a universal binary, but macOS 15, macOS 26 and the Intel slice have never been run.453- **Memory grows with the number of objects** (about 125–160 bytes each). A whole-disk scan of a Mac with 15 million files would need roughly 2 GB; not measured.454- **Scan results are not persisted**: quitting the app discards the tree.455- **Recoverable space is an estimate.** Clones, snapshots and purgeable accounting are outside the app's control; private sizes of a folder are a lower bound.456- **Leftover and name-based associations are inferences**, labelled as such.457- **The "unused" notion does not exist in the app**: only modification dates and Spotlight's last-used date, when recorded.458- **Root-owned items** (some App Store or system-wide installs, `/Library` caches) cannot be removed, because the app never elevates privileges; the attempt is reported as failed.459- **History is recorded only while the app runs.**460- **Similar images**: thresholds were calibrated on generated pictures; behaviour on large real photo collections has not been evaluated. Photo libraries are not opened.461- **Similar-image and treemap panning with a mouse wheel** are not implemented (pinch and drag only).462- **Increase Contrast is not handled** by the custom colours and the map; the density setting applies to the Large Files list only.463- **No automatic updates.**464- **Sandbox**: the app is not sandboxed (a disk analyzer needs broad read access), so it cannot be distributed on the Mac App Store as is.465466## 34. ORIX Ecosystem467468| App | Platform | Purpose |469|---|---|---|470| **ORIX Clean** | macOS | Storage intelligence and cleanup |471| ORIX Scan | iOS / iPadOS | Document scanner with on-device OCR |472| ORIX Calc | iOS / iPadOS | Universal calculator |473| ORIX Audio | iOS / iPadOS | Recorder with on-device transcription |474475Shared principles: no account, everything on the device, every advertised feature works, every limitation is written down.476477## 35. License478479All rights reserved © 2026 Simon-Pierre Boucher. See [`LICENSE`](LICENSE).480481---482483<div align="center"><sub><b>ORIX Clean — Reclaim Space. Keep Control.</b><br>Author: Simon-Pierre Boucher · contact@spboucher.ai</sub></div>484