Home and your files

Home is Brello’s view of every file in your home folder, sorted by kind, with what Clean up found under it. Open it with Option-Command-2. Its lists work with Finder’s keys: Space for Quick Look, Command-I for the Inspector.

On any Mac with macOS 14 or later

All help topics

Home is Brello PI’s view of every file in your home folder, sorted by what it is rather than where it’s kept. It opens with the Library, every kind of file with its count and size, and Clean up, what you probably don’t need, and it has a search field that takes plain English. Home works on every Mac Brello PI runs on, with or without the agent.

Open Home

Click Home in the sidebar, near the top, or press ⌥⌘2. Brello reads your files on your Mac when it opens and keeps Home up to date as files arrive and change. Above the page, Brello says when it last read them, such as Updated just now.

  • The Library. Images, Videos, Music, Documents, Archives and Apps, each with how many files and how much space they take, and a glimpse of the latest. Click one to see all of that kind, wherever the files are kept.
  • Clean up. Cards for Duplicates, Old Screenshots, Old Installers, Big Old Videos, Forgotten Downloads and Unused Apps, each with its total, and what Brello can free in all, each file counted once. Click a card to see its list. See Clean up.
  • The search field at the top. Type what you remember, such as “PDFs from last week over 5 MB”. See Search in plain English.

Where Home looks

Home shows the files in your home folder: Desktop, Documents, Downloads, Pictures, your other folders and iCloud Drive. macOS asks you once before Brello can read some of them, such as Desktop, Documents and Downloads. If you said no to one, Home leaves out what’s in it and says which folder it can’t see, with Open System Settings. See Brello can’t see my files.

Brello reads your files only on your Mac. It never uploads them, their names or their contents.

The sidebar

Section What’s in it
(top) Agent, Home and Health
Library Recents (files you opened in the last 30 days), each kind of file, and searches you’ve saved
Lists Large Files (files larger than 100 MB), Screenshots and Downloaded from
Clean up Its six lists, and Storage
Brello PI Activity, Routines, What Brello PI knows, Privacy and Settings
Locations Your folders, and any you’ve pinned

Each row shows a count or a size on the right. ⌃⌘S hides the sidebar, and it folds away on its own when the window is too narrow for it.

Working with files

Every list in Home works the way Finder does, with Finder’s keys:

  1. Click a file to select it; ⌘-click or ⇧-click to select more.
  2. Press Space for Quick Look, ⌘O to open, ⌘I for the Inspector, or ⇧⌘R to show it in Finder.
  3. Choose View as a grid of thumbnails (⌘1) or a list with names, sizes and dates (⌘2), and change the thumbnail size with ⌘= and ⌘−.
  4. Use Sort By to order by Best Match, Newest First, Oldest First, Largest First, Smallest First, A to Z or Z to A.
  5. Drag files out of Brello into Finder, Mail or any app.
  6. Choose Delete… (⌘⌫) to move files to the Trash. Brello asks first, and ⌘Z puts them back. See Delete files, and put them back.

⌘F goes to the search field, and ⌘[ and ⌘] go back and forward. Keyboard shortcuts lists every key.

With the agent, selecting files also offers to Ask Brello about them, such as moving them into a new folder, renaming them by what’s in them, or summarizing a document.

Quick Look and opening files

  1. Click a file to choose it.
  2. Press Space, or ⌘Y, or double-click it. Quick Look, Apple’s own preview panel, opens over Brello.
  3. Press ↓, ↑, ← or → to step through the files in the order shown. Quick Look follows.
  4. Press Space or esc to close Quick Look. Press esc again to let go of the chosen file.

A double-click on a folder opens it in place, and a double-click on an app previews it rather than running it. To open a file in its own app, press ⌘O.

Quick Look shows whatever macOS’s Quick Look can: images, PDFs, documents from Pages, Numbers, Keynote and Microsoft Office, text and code, audio, video, 3D models and more. Apps you install can add their own previews. A file Quick Look can’t preview shows its icon and details.

Where it works

  • Home’s pages and search results: every kind, list and folder.
  • Duplicates: each copy previews with Space, and the arrow keys walk from copy to copy across the sets.
  • The agent’s replies: the files a search found, what a request changed (moves before and after, renamed files), the copies of a duplicate, and the items a question is about. A double-click on a reply’s tile shows Quick Look; Open is in the tile’s menu. A file a request has removed is no longer on your Mac, so its tile isn’t previewed.
  • The popup: ⌘↩ shows a file in Brello PI, where Quick Look is one key away.

If Space doesn’t preview

  • The search field has the keyboard: press Tab or click a file first, so the space goes to the files and not into the field.
  • No file is chosen: click one.
  • The file is gone: it may have been moved or renamed since it was listed. Brello says so.

Inspector and Copy Text

Quick Look shows a file full size and closes when you’re done. The Inspector stays open beside the files and shows a smaller live preview with the file’s details.

  1. Select a file anywhere in Home.
  2. Press ⌘I, or choose Show Inspector.
  3. To close it, press ⌘I again, or choose Hide Inspector.

The Inspector shows each file you select. With nothing selected, it says “Choose a file to see its details here.”

Part What you’ll see
Preview A live preview of the file. In images and PDFs you can select text with Live Text, as in Preview
Information Kind, Size, Where, Created, Modified and Last opened
Photos Dimensions, Camera, Lens, Exposure and ISO, and when it was Taken
Music and video Duration, and a song’s Title, Artist and Album
Downloads Downloaded from: the site the file came from, as your Mac recorded it
Folders How many Items it Contains, and of which Kinds

Show in Finder at the bottom opens the file’s folder in Finder with it selected.

Copy Text

Copy Text reads all the words in an image or a PDF on your Mac and puts them on the clipboard.

  1. Select an image, a screenshot or a PDF.
  2. Press ⇧⌘C, or choose Edit ▸ Copy Text. It’s also in the menu you get by Control-clicking a picture or a PDF.
  3. Brello reads all of its text on your Mac and copies it. Select several files to copy their text one after another, in order.
  4. Paste it anywhere with ⌘V.

Copy Text uses Apple’s own text recognition, on your Mac. Nothing is uploaded. It works on photos of documents, receipts and whiteboards as well as screenshots, and on PDFs: a page with its own text layer is read from it, and a scanned page, whose words are only a picture, is read from the picture, up to 10 such pages at a time.

To copy just part of the text, such as one phone number, use the Inspector’s preview instead: drag across the words you want with Live Text and press ⌘C.

If Copy Text finds nothing:

  • The text is too small or blurry: open the image larger and try again, or crop it to the text.
  • It isn’t an image or a PDF: for documents, open them and copy as usual.
  • Handwriting: neat handwriting is often read; untidy handwriting may not be.

Copy the file, or its path

  • ⌘C copies the file itself, ready to paste into Finder or an email.
  • ⌥⌘C copies its path, such as ~/Downloads/Invoices/March.pdf, ready to paste into Terminal or a document.

Pin folders to the sidebar

  1. Find the folder anywhere in Brello PI: in Home, in a search, or in one of the agent’s replies.
  2. Select it and press ⌃⌘T, or Control-click it and choose Pin to Sidebar.
  3. It appears in the sidebar under Locations, after Desktop, Documents, Downloads, Pictures, Movies and Music, and stays there between launches.

Click it to see its files in Home. Pinning changes nothing about the folder itself: it’s a shortcut in Brello’s sidebar, as in Finder’s. Pins are kept with your other Brello settings on your Mac, and each Mac has its own.

  • What can be pinned: a folder inside your home folder that isn’t hidden. An app, a package or a single file can’t be pinned; for a group of files spread across folders, save a search instead.
  • Put them in order: drag a pinned folder up or down in the sidebar. Your order is kept, and the standard places stay above. Go ▸ Locations in the menu bar lists them too.
  • Unpin it: Control-click it in the sidebar and choose Remove from Sidebar. Elsewhere in Brello, a pinned folder’s menu offers Unpin from Sidebar. The folder itself, and everything in it, stays where it is.

When a pinned folder goes missing

If you move, rename or delete a pinned folder in Finder, its place in the sidebar stays, marked Missing, with a question-mark folder, so the sidebar doesn’t jump. Unpin it, then pin the folder from its new place. A folder on an external drive or in a cloud folder that isn’t available right now shows as missing until the drive is back.

Pinned folders and the agent

With the agent, you can name a pinned folder in a request the way you’d name any folder, such as “move these into Clients” or “what’s in Finance from last month?”. In the popup, type @ and the folder’s name to point a request at it. Brello PI can change files only in your Desktop, Documents and Downloads, so a pinned folder elsewhere can be looked at and searched, and Brello PI says so if a request would change it.

Downloaded From

Downloaded From groups the files you’ve downloaded by the site they came from: every invoice from your bank together, every installer from a developer. Click Downloaded from in the sidebar under Lists, or press ⇧⌘J. Brello says Looking at where your downloads came from while it reads them. Each site is a group, with how many files came from it; click a site to see all of its files, and use Sort By to see the newest or the largest first.

When you download a file in Safari, Chrome or most other apps, macOS records where it came from with the file. Brello reads that record, so there’s nothing to set up. It groups by the page you downloaded from, not by the storage server that sent the file, so a file from a newsletter shows under the newsletter’s site rather than under a content delivery network’s name. Attachments you saved from Mail or a chat app are grouped by where they came from, where the app recorded it. Brello never visits the site, fetches its icon, or sends anything about your downloads anywhere.

The Inspector (⌘I) shows the same thing for any one file, under Downloaded from.

Why a file isn’t listed

  • macOS didn’t record a source. Files you made yourself, copied from a disk, or downloaded with an app that doesn’t record it have no site.
  • The record was removed. Some apps, and some ways of copying files, drop it.
  • The folder isn’t one Brello can see. See Brello can’t see my files.

If no site has been recorded yet, Brello says “Files you download from the web, email or chats show up here, by where they came from.”

Play music from Home

Brello plays the songs in your Library without opening another app.

  1. Open Music in the sidebar under Library, which lists every song in your home folder, or find a song with Home’s search, which reads a song’s name and folder.
  2. Double-click a song.
  3. It plays in a small player in the middle of Brello’s toolbar, with the song’s own cover, its title and artist from its tags (or its file name and folder), a thin bar showing how far in it is, play and pause, and a button that stops it.

The player appears only while a song is loaded. To preview a song without playing it in the player, choose it and press Space for Quick Look.

Do this Key or control
Play or pause The media key, or the toolbar’s button
Next song ⌘→, or Controls ▸ Next Song, or the media key
Previous song ⌘←, or Controls ▸ Previous Song, or the media key
Stop The toolbar’s stop button, or Controls ▸ Stop

Next and previous step through the songs in the same folder, by name, the way an album folder lists them. Previous restarts a song if it’s a few seconds in, as Music does. After the last song, the player stops. While you’re typing in a text field, ⌘← and ⌘→ move through the text as usual instead.

While a song plays, Brello tells macOS what it is, so the song’s title, artist, album and cover appear in Control Center and the menu bar’s Now Playing, and their controls work. When the player stops, Brello hands Now Playing back to whatever app had it. Brello stops the song when it quits.

What it plays

Song files on your Mac that hold their own sound, such as MP3, AAC, M4A, WAV, AIFF and FLAC files macOS can play. It never plays a playlist, a web address or anything that would reach the internet, so nothing is streamed or fetched. For playlists and a library, use Apple’s Music app.

If a song won’t play:

  • It’s in iCloud and not downloaded: download it in Finder first.
  • It isn’t a sound file macOS can play: open it in the app that made it.

If Home looks wrong

  • A kind shows fewer files than you expect: a folder may be one macOS hasn’t let Brello see.
  • A file you just made isn’t there yet: Brello updates as files change; give it a moment, or press ⌘F and search for it.
  • A file shows that you moved: choose it and Brello reads it again. If it’s gone, Brello says it may have been moved or renamed since it was listed.

Still stuck? Write to hey@brello.ai with what you typed or clicked and what you saw.