Reference
Library and drives
Last updated November 10, 2026
There's no new library to move into. Your folders stay exactly as they are, on the drives you already use, and Grain builds a catalog on top of them. Every drive becomes part of one library you can browse and search.
Your sources
Your drives appear under Sources in the sidebar: your Mac's own disk, external drives, network shares and Dropbox. Each shows how many photos and videos Grain has cataloged on it, and the folders inside are one click away. To leave a drive or folder out of your library, Control-click it and choose Hide From Grain. Your files aren't touched. A drive you've unplugged stays in the list, marked as disconnected, and its work stays in your library.
Not another thing to manage
- Your MacInternal and expansion drives
- External drivesHard drives, SSDs, and cards
- Network storageNAS and shared drives
- DropboxOther clouds coming soon
One libraryOne library, on your Mac
Most photo apps start with an import, and from then on you have two things to look after: your folders, and the app's copy of them. Move a shoot, rename a folder or add a drive, and the catalog falls behind until you fix it.
Grain's import works a little differently. All it does is scan and read your files where they are. There's no migration, no upload and no copying, and nothing to keep in sync by hand. Your folders are the library. Grain keeps a catalog on your Mac, a record of every photo and video it has seen and everything it has learned about them, and it watches your folders so the catalog keeps itself up to date as you add or remove files. Network drives are checked again each time Grain opens.
Stays on your drives
- Your originals, in your folders
- The names and structure you chose
- Nothing added, moved or renamed
Lives in Grain's catalog, on your Mac
- Where every file is, and a preview of it
- Details read from your files: dates, camera, XMP and IPTC
- What Grain learns: what's in each photo, what's said, who's in it
- Your ratings, labels, tags, collections and clips
So there's no migration to plan and no second library to maintain, and nothing about Grain locks you in. Your folders keep working in Finder, Lightroom, Premiere or any other app, exactly as before.
Three words you'll see
Source
- A drive or folder Grain catalogs: your Mac, an external drive, a NAS share or Dropbox
- Listed under Sources in the sidebar
Folder
- A folder on a source, shown exactly as it is on disk
- Open one to see its photos and videos
All Media
- Every source together, in one view
- Images and Videos narrow it to one kind
Adding your work
Opening a folder is enough. Click its name in the sidebar, and Grain starts cataloging it and everything inside it. Click a drive to bring in the whole drive. To pick several folders at once, Control-click the drive and choose Select Folders…. To see everything Grain is cataloging, open File → Source Settings….
Not sure whether to add a whole drive or just some folders? Getting started walks through the choice.
While Grain gets to know a folder
Cataloging happens in two passes, and you don't have to wait for either one:
- Search Index: Grain records each file, its details and a preview. Browsing works right away.
- Visual Analysis: Grain looks at each photo and video on your Mac, so you can search by what's in them. Transcription and face grouping run in the background too.
Click the folder's title at the top of the window to see both passes for that folder. Search gets better as analysis completes, so keep working while it runs.
One library across every drive
Once a few sources are in, stop thinking in drives. All Media shows every shoot together, with photos and footage side by side.
- Collections gather work from any drive without moving it.
- Favorites pin the sources, folders, collections and searches you return to.
- A photo that exists on two drives appears once, and the inspector lists every copy.
When a drive is unplugged
A drive in a drawer is still part of your library. Its photos and videos keep their catalog details and the previews on your Mac. Turn on View → Include Disconnected Sources to bring them back into All Media and search. The inspector names the drive, so you know which one to plug in.
Plug the drive back in to open, export or reveal an original. Previews make browsing possible, but they aren't a backup of your files.
Shortcuts
| Keys | What they do |
|---|---|
| ⌘[ ⌘] | Back and forward, between the views you've visited |
| + − | Make the gallery's thumbnails bigger or smaller, from anywhere in the window |
| ⌘F | Search the current view |
| ⌃⌘F | Full screen |
Every shortcut in Grain is on one page: keyboard shortcuts.
What Grain never does to your files
- It never moves, renames or changes your originals. A file goes to the Trash only when you choose Move to Trash.
- Your ratings, tags and other edits stay in Grain's catalog. They aren't written back into your files or XMP sidecars.
- Removing something from a collection never touches the file.
For the details of what's stored where, see how Grain handles your files.
Every control, at a glance
- Browse existing folders
- Get straight to the work, in the structure you know. Choose a source and folder in the sidebar. Expand its arrow to see subfolders; choose the folder itself to open its gallery.
- One view across sources
- See work from different drives together. All Media brings indexed sources into one gallery. Images and Videos give you dedicated views of each media type.
- Index files in place
- Keep your existing editing and storage workflow. Grain records files in its catalog without importing copies into a managed originals library.
- Browse while indexing
- Start working before the whole archive is ready. Browse available files while the search index and visual analysis continue in the background. Search coverage grows as analysis completes.
- See indexing progress
- Know what is ready to use. Open the folder title’s progress view to see search indexing and visual analysis separately.
- Keep disconnected drives in your catalog
- Find your way back to work on an unplugged drive. Include disconnected sources when searching to use their saved catalog information and available cached previews. Reconnect the drive to open or export an unavailable original.
- Back and forward
- Move between a search and the folder you were exploring. Use the navigation controls, Command-[ for Back, and Command-] for Forward.
- Recently added media
- Return to new material without hunting through folders. Use Recents to revisit newly added assets in your folders.