How Arrayo decides
Arrayo follows plain rules that run on your Mac. This page explains how it reads a folder, picks names and folders, and why you always see the plan first.
Checked against the app: 18 Nov 2026
Rules, not guesses
Arrayo has no AI model and no cloud service behind it. It uses fixed rules, so the same folder gives the same plan every time. The only "reading" it does is Apple's own text tools (PDFKit and Vision) on your Mac, to find the date and sender in a document.
When a rule isn't sure, Arrayo says so, or leaves the file alone. It would rather skip a file than rename it wrongly.
A cleanup in six steps
- Scan. Arrayo looks at the folders you pick and counts files by kind. This step only reads names, types, sizes and dates. Nothing is opened, renamed or moved.
- Score. It gives the folder a tidy score from 0 to 100, with the reasons.
- Three questions. What you use the Mac for, how you think about your files, and whether you browse or search.
- A folder system. Based on your answers, Arrayo suggests one. You can pick another or build your own.
- Preview. Every planned change is listed: the current name, the new name, the destination and how Arrayo recognised the file. You can edit a name or untick a file.
- Apply. Only when you press Apply do files move. The cleanup is saved so you can undo it.
How it picks a new name
Names put the date first, then who and what: 2026-11-12_Telekom_Invoice.pdf. Sorted by name, files then line up in time order.
The date comes from the best place Arrayo can find: a date already in the file name, the text of the document, the photo's own date, or the file's own date. The preview shows which one it used. Version tags like v2 are kept.
Names that are already clear are left alone and marked "Already tidy". Typical ones it cleans up:
IMG_4821.JPGbecomes2026-11-MADEIRA_001.jpg(or a date-based name if place names are off)Screenshot 2026-11-04 at 21.18.02.pngbecomes2026-11-04_Screenshot.pnginvoice_final_FINAL.pdfbecomes a name with the date and sender, if Arrayo can read them
If two files would get the same name, Arrayo adds _2, _3 and so on. It never overwrites.
How it reads an invoice
For PDFs, Arrayo reads the first three pages on your Mac. It uses the text layer first. If a page has no text, as in a scan, Apple's on-device text recognition reads the first page. The text is held in memory only and is gone when you quit.
From that text it looks for three things:
- The type. Words like invoice, Rechnung, receipt, Quittung, contract or Vertrag. The one that appears first wins, because titles come first.
- The date. A labelled date, such as an invoice date, is trusted more than a loose one. An ambiguous date, like 03/04, is trusted less.
- The sender. A name is only trusted if Arrayo knows the company, or if it is a line that ends in a company suffix like GmbH.
Each read gets a confidence level: high, medium or low. A weak read never puts a sender into a file name. A scan has to be read clearly before it counts as high. Anything below high goes onto a Check these list at the top of the preview, so you look at it before you apply.
How it picks folders
With the By file type system, the first rule that matches decides, in this order:
- Copies of a file you already have go to Duplicates.
- Topic folders, such as Taxes & Admin, Travel and Health.
- Installers.
- Design source files.
- Project folders. A project is a folder you already have, or a word that several files share.
- The folder for its type: Images, Videos, MP3, PDF and so on.
The other systems work in the same way: Projects and clients puts your projects first, Life areas uses a few lasting areas, By date uses year and month, and Make my own follows the structure you build.
Arrayo only sorts files that sit directly in the folder you chose. Folders already inside it are never moved, so a project in your Downloads stays whole. Files that fit nowhere go to an Archive folder, never the Trash.
Photo trips
Arrayo reads each photo's built-in date and location. Photos taken close together are grouped into one trip, and a new trip starts after a longer gap. The photo itself is never opened or changed. Place names are off by default. If you turn them on, Apple gets one position per trip to look up the name, never the photo.
How the tidy score works
The score measures four things, and the page shows exactly what each costs you:
- Names that say little, like
IMG_4821,Scan10012orUntitled - Different kinds of files mixed in one pile
- How many files are waiting to be sorted
- Files that aren't in folders yet
The score is a friendly reading, not a grade. Files that are already filed with clear names cost nothing, so a finished cleanup can reach 100. Dumping everything into one folder doesn't count as tidy.
Why you stay in charge
You see every change before it happens. You can edit any new name or leave a file out. Arrayo only renames, moves and creates folders. It never deletes and never overwrites. Each cleanup is saved with the old and new place of every file, so Undo works later, even after a restart. If something is in the way, Undo moves nothing and tells you why.
Want to see it for yourself? Try it on a copy of a folder with Wi-Fi off. Everything works offline, and nothing is changed until you press Apply.
For what the app reads and saves, and every network call, read How Arrayo works. For privacy, see Privacy. Questions? Write to hello@arrayo.app.