Frames · Manual
Learn to use Frames
78 guides across 7 chapters. Find instructions for importing, organising, choosing and editing photographs.Browse all features by area.
Starting out
8 featuresFrames works across Mac, iPhone, iPad, Duo and Apple TV. Use Browse to find photographs, Choose to review a shoot and Develop to edit. This chapter covers the devices, the trial, adding sources and the main controls.
What it does
Choosing in four phases
Review a shoot in four phases: Sweep, Rate, Inspect and Cleanup.
Modes, views and phasesVerdicts and ratings
Keep or reject photographs and rate them from one to five stars using separate controls.
The ideas it is built onOriginals on demand
Browse local previews and load originals when you pause in Loupe, zoom, edit or request them.
The ideas it is built onNon-destructive editing
Edits are stored in Frames’ catalogue and leave original files unchanged.
The ideas it is built onCommitted dark
The interface stays dark in every system appearance to keep viewing conditions consistent.
The ideas it is built onSource setup
Add Apple Photos or a folder from the source picker, with guidance through the first scan.
Adding your first sourceGlowing app icon
After purchase, choose the glowing golden icon in the purchased section of Settings. The choice is saved on each device.
The trial, and buying FramesGetting started
Start with small tips on Choose, Keep and Develop, meet other features through later tips, and open in-app guidance whenever you want to learn more.
Getting started
Pages
- 1.1What Frames is
Frames is a RAW editor and catalogue for macOS, iOS and iPadOS, with Browse and Present on tvOS.
- 1.2The trial, and buying Frames
Try every feature free for 30 days, then buy Frames for $99.99 with a single payment.
- 1.3The ideas it is built on
Frames keeps selection, editing and file deletion separate, and uses local previews to browse your library.
- 1.4Adding your first source
Add Apple Photos or a folder to start browsing photographs in Frames.
- 1.5Getting started
Getting Started explains the current view and its controls as you work, from adding photographs to exporting an edit.
- 1.6Modes, views and phases
Use B, C and D to switch between Browse, Choose and Develop.
Getting photographs in
8 featuresAdd Apple Photos, folders or mounted drives as sources to catalogue photographs where they are. Import from a camera card to copy photographs into Apple Photos or a folder.
What it does
Photos in place
Catalogue your Apple Photos library without copying or relocating originals.
The Photos libraryFolder sources
Browse folder and drive sources alongside Apple Photos in one catalogue. Review missing originals and scan failures with file paths and retry actions.
Folder and mounted-volume sourcesLibrary sync
Sync source changes while preserving ratings and verdicts for missing photographs that may return.
Library syncFolder sync
Folder sources refresh on launch, mount and manual scan, with automatic change detection on local drives.
Folder and mounted-volume sourcesCard import
Import card photographs grouped by session, with duplicate checks and RAW+JPEG pairing.
Card importLocations from a Track
Place photographs without a location by matching their capture times to a recorded route, at card import or afterwards. Correct the camera clock on a timeline. Existing locations are kept.
Locations from a TrackFolder destinations
Import to a folder using date and sequence patterns, with existing-file protection and source-coverage information.
Card importOriginal downloads
Fetch iCloud originals as needed, share matching requests and cache completed downloads locally.
Downloads
Pages
- 2.1The Photos library
Add Apple Photos as a source to browse its still photographs using locally available previews.
- 2.2Folder and mounted-volume sources
Add a folder or mounted drive to catalogue its photographs without copying the files.
- 2.3Card import
Import photographs from a camera card into Apple Photos or a folder on disk.
- 2.4Locations from a Track
Place photographs that have no location by matching their capture times to a route you recorded.
- 2.5Library sync
Click ⟳ beside a source to sync it, or let changes in Apple Photos trigger an automatic sync.
- 2.6Decision sync
Turn on Sync across your devices to carry your photographic decisions between Frames on Mac, iPhone, iPad and Apple TV through your private iCloud account.
- 2.7Star meanings and Photos favorites
Give each star rating your own short meaning in Settings.
- 2.8Downloads
Frames downloads originals from iCloud when an action needs them, and uses local proxies for the grid.
Browse
27 featuresPress B to find photographs across your sources. Browse has a collection tree and its own filters, independent of Choose phases. Use it to organise Photos albums and folders, and export finished photographs.
What it does
Frames treatment sidecars
Carry named treatments and their original recipe JSON beside folder photographs. Review imports, keep existing treatments and undo unchanged imports.
Portable treatments and cataloguesAutomatic XMP exchange
Opt into debounced metadata exchange for connected folders. Independent changes merge; conflicts wait for review. Pick and Reject use Frames’ verdict property.
Portable treatments and cataloguesCatalogue recovery and transfer
Export a consistent catalogue with metadata and treatments, without filesystem grants. Stage a validated import or backup restore for the next launch and retain the previous catalogue.
Portable treatments and cataloguesJourney
Explore the current Browse result on a map of photographed stops and a day timeline, each stop named after its place or town. Open a photograph in Loupe and return to the same day and map position.
JourneySlideshow
Present kept and developed photographs from Browse, with large controls that hide automatically, a slow drift and a choice of transition.
PresentingBatch edit
Paste a treatment onto a selection after reviewing affected treatments and downloads.
Developing a selectionBrowse
Browse a whole source, an album or a collection, then search and filter within it.
The collection treeLibrary organising
Create and organise Photos albums and folders from Browse, with changes synced through Photos.
Organising the libraryExplore drawer
Explore predefined categories and visual styles with suggestions and matching counts from your collection.
The Explore drawerScene tags
Detected words describe photographs and can be clicked to filter the library.
Searching photographsPhotographs like this one
Press S to find up to 100 visually similar photographs, subject to active filters.
Searching photographsKeywords you type
Add keywords to a photograph and search them alongside detected words.
Words of your ownCaptions and credit
Add captions and credit for export; on Mac, edit capture metadata and exchange XMP sidecars.
Captions and creditSaved searches
Save queries and filters under a name in the sidebar, with counts that update as the catalogue changes.
Saved searchesMonochrome filter
Filter Browse to photographs whose selected treatment uses Monochrome.
Working in BrowseExport
Press E in Browse to export to a folder or the macOS share sheet. Choose format, size, metadata and naming, with download and space estimates.
ExportBrowse filters
Narrow photographs by rating, RAW files, edited treatments and Monochrome, alongside search.
Working in BrowseExport colour spaces
Choose sRGB, Display P3 or Adobe RGB, with ProPhoto available for 16-bit output.
ExportResize and sharpen
Resize by long edge or percentage and apply output sharpening after resampling.
ExportMetadata controls
Choose whether exports include camera information, capture date, location and copyright.
ExportFile naming
Build folder and filename patterns from dates, sequence numbers and photograph metadata.
ExportExisting-file handling
Choose Replace, Skip or Keep both for files already at the export destination.
Export
Pages
- 3.1Working in Browse
Explore photographed places and days with [Journey](/docs/journey), the map beside Grid, Loupe and Compare.
- 3.2Journey
Explore the photographs in the current Browse result where they were taken.
- 3.3Sets
Sets group related photographs, such as bursts, bracketed exposures or several attempts at a composition.
- 3.4Presenting
Present fills the screen with one photograph at a time, so you can show a shoot to a customer across the table or a holiday to the family.
- 3.5The collection tree
The sidebar lists your places in four parts: Library, Collections, Sources and Devices.
- 3.6Collections
Collections are groups of photographs you gather in Frames, kept in your catalogue, in an order you set by hand, and carried to your other devices when Sync is on.
- 3.7Searching photographs
Search finds photographs using words Frames detects, keywords you add and text in your captions.
- 3.8The Explore drawer
The Explore drawer groups refinements into Explore, Keywords, Date, Gear and Rating & Status tabs.
- 3.9Words of your own
Add keywords to individual photographs, then search for them in Browse or include them in exported files.
- 3.10Captions and credit
Add titles, captions and credit, correct capture metadata, and exchange metadata with XMP sidecars on Mac.
- 3.11Portable treatments and catalogues
Carry folder metadata and Frames treatments to another Mac, and recover a catalogue while keeping the previous file.
- 3.12Saved searches
Save a Browse query and its filters to run it again in any collection, with an updated library-wide result count.
- 3.13Developing a selection
Copy a treatment and review how its recipe will be applied to one photograph or a selection.
- 3.14Organising the library
Create, rename, move and delete Photos albums and folders from Browse’s collection tree.
- 3.15Export
iPhone and iPad.
Choose
11 featuresPress C to review a shoot in four phases: Sweep undecided photographs, Rate those kept, Inspect the highest rated and review rejects in Cleanup. Each phase supports Grid, Loupe and Compare.
What it does
Capture metadata sync
Share camera, lens and exposure details between devices after one device reads the original.
LoupeGrid
Browse adjustable thumbnails with range selection, four sort orders and rating and verdict marks.
GridNavigator and glass
Use the navigator above fit or press G at fit to inspect a detail at 100%, 200% or 400%.
Looking closelyDevelop prewarm
Frames prepares the editing render while you pause on a photograph in Loupe, with progress in the control band.
LoupeSafe delete
Delete photographs only from Cleanup, with confirmation before files are removed.
Deleting, in Cleanup onlyHonest histogram
Measure the histogram from original decodes and click clipping indicators to highlight affected pixels.
LoupeReview controls
Use the control band to change phase, rate photographs and track review progress.
Working in ChooseReview rail
Use phase-specific controls for keeping, rating and rescuing photographs, with position and verdict in the status bar.
The rail
Pages
- 4.1Working in Choose
Choose helps you review a shoot through four phases, with keyboard controls for keeping, rejecting and rating photographs.
- 4.2The rail
Choose’s left rail is a card for the current phase: what it is for, its actions with their keys, your progress and the way on.
- 4.3Grid
Press ⌘1 to view photographs as thumbnails at an adjustable size.
- 4.4Loupe
Press ⌘2 to view one photograph with zoom, a filmstrip and an optional info panel.
- 4.5Looking closely
Use the navigator to move around a zoomed photograph, or the magnifying glass to inspect detail while the whole photograph stays visible.
- 4.6Compare
Press ⌘3 to compare up to six photographs side by side with linked zoom and panning.
- 4.7Deleting, in Cleanup only
Use Cleanup’s red delete button to remove selected rejects, or all rejects in the phase when none are selected.
- 4.8Folding the device
On a folding iPhone, Frames arranges itself for the way the device is being held.
Develop
44 featuresPress D to edit one photograph. Frames saves adjustments as a recipe in its catalogue and leaves the original file unchanged. Each photograph can have any number of versions alongside ORIGINAL.
What it does
Colour grading
Tint shadows, midtones, highlights or the whole selected target with one wheel, exact numeric controls, Balance and Blending. Works on Background and mask layers.
Colour gradingPerspective correction
Correct convergence with Vertical, Horizontal and Aspect, or align four guides. Constrain Crop keeps empty edges out while preserving the stored crop.
Perspective correctionVersion comparison
Reveal a saved reference and the editing version with a movable divider, shared framing and one zoom and pan. The reference recipe stays unchanged.
Comparing versionsRecipes
Frames saves adjustments automatically as recipes, including when you leave a photograph or quit during a drag.
Entering DevelopCopy and paste edits
Copy with ⇧⌘C and review with ⇧⌘V. Apply chosen adjustments to one or many frames as new versions by default, with explicit update choices and guarded Undo. The copied recipe survives restarts and is shared by windows on this device.
Undo, RESET, bypass and copyingRAW 9 decoding
Frames uses Apple’s on-device RAW 9 decoder for files that support it.
How a RAW file becomes a picturePer-camera controls
Develop shows the RAW controls supported by each photograph and its decoder.
How a RAW file becomes a pictureWhite balance
Adjust temperature and tint, or sample a neutral area with the RAW white-balance picker.
White balanceTone curve
Edit composite and RGB point curves directly, or drag on the photograph to adjust a sampled tone.
The tone curveColour mixer
Adjust hue, saturation and luminance across eight colour bands, selected directly or from the photograph.
The colour mixerLooks
Apply one of 32 included looks at adjustable strength, save your own or import Lightroom presets.
Working with looksMonochrome process
Switch to Monochrome for black-and-white conversion controls and toning.
MonochromeLens filters and bands
Choose a monochrome filter and adjust eight bands to control how original colours become grey.
MonochromeToning
Tint monochrome shadows and highlights with presets or hue, strength and balance controls.
MonochromeVibrance and saturation
Adjust overall colour intensity with two controls in the Colour group.
The controlsPresence
Adjust clarity, texture and dehaze across the photograph or within a mask.
Presence and effectsVignette and grain
Add a crop-relative vignette and film grain. Choose a stock and format in the grain popover, with a preview strip below.
Presence and effectsGrain of its own
New grain edits use a photograph-specific pattern that remains stable between renders.
Presence and effectsLens corrections
Apply a saved lensfun profile or manual distortion adjustment before other edits.
Lens correctionsRAW detail controls
Use the sharpness, noise, moiré and other Detail controls supported by the current RAW file.
The controlsHDR gain map
Adjust HDR strength on supported RAW files with a gain map, starting from zero.
The controlsCrop and straighten
Crop with eight aspect choices including Free, five composition guides and four ways to set the angle.
Crop and straightenRotation and flips
Rotate the cropped photograph left or right in 90° steps, or flip horizontally and vertically. Close the crop tool with Done to use the orientation buttons.
Crop and straightenAuto Level
Detect and level a horizon automatically, with a message when no horizon is found.
Crop and straightenSpot and stroke repairs
Press Q, then click to heal or clone a spot. Option-drag paints a longer repair; drag an empty area to pan.
Repairing a photographFound repair source
Frames finds nearby source material for each repair. Drag the source grip to choose a different area.
Repairing a photographDust maps
Save sensor spots and apply them to a selection or camera date range, with a summary and one-step undo.
Repairing a photographFind dust
Press ⇧K in Develop to highlight possible sensor dust and adjust the detection threshold.
Repairing a photographComposition review
Explore framing from your intention, measured observations and suggested crops. Currently available on Mac.
Composition reviewSnapped repair stroke
Enable Snap to extend a repair stroke over detected objects it crosses.
Repairing a photographInteractive rendering
Most adjustments use a cached RAW decode, while RAW white balance and Detail trigger a new decode.
The controlsEdited previews
Saved edited previews let Grid display the selected treatment and its edited mark.
Entering DevelopMoving a treatment
Copy and paste between treatment segments, with confirmation before replacing edits and undo when full restoration is available.
VersionsPublish to Photos
Allow publishing to send edited renderings to Photos, with Revert available and iCloud Photos sync supported.
An edit reaches Photos.appOn-device AI
RAW processing, mask detection and horizon detection run on your device.
How a RAW file becomes a pictureDevelop Field Guide
Question marks beside Develop’s controls open an explanation of what each does, what to try and how Frames processes it.
Learning to developAuto tone
Set a starting point for the six Tone sliders with one click and undo it in one step.
The controlsSoft proofing
Preview sRGB, Display P3, Adobe RGB or ProPhoto and highlight out-of-gamut colours.
Soft proofingUndo and reset
Undo edits to the current photograph, reset an adjustment group or bypass it temporarily.
Undo, RESET, bypass and copying
Pages
- 5.1Working in Develop
Press D to edit a photograph, with adjustments in the sidebar and the current selection in the filmstrip.
- 5.2Entering Develop
Press D to open the selected photograph for editing and load its original if needed.
- 5.3The controls
Develop’s sidebar groups adjustments by purpose and shows only controls supported by the current photograph.
- 5.4Learning to develop
Learn Develop’s controls beside the photograph, with a field guide that explains what each adjustment does, what to try and how the processing works.
- 5.5Crop and straighten
Press R to crop or straighten a photograph, then press it again to view the cropped result.
- 5.6Perspective correction
Perspective correction straightens converging edges without changing the original photograph.
- 5.7White balance
Adjust temperature and tint with sliders, or press W on a RAW photograph to sample a neutral area.
- 5.8The tone curve
Use point curves to adjust overall tone or individual red, green and blue channels.
- 5.9The colour mixer
Adjust hue, saturation and luminance for eight colour ranges, or press H to select a range from the photograph.
- 5.10Colour grading
Colour grading gives shadows, midtones, highlights and the whole photograph their own colour and brightness.
- 5.11Monochrome
Choose Monochrome at the top of Develop’s sidebar to convert a photograph to black and white and adjust its colour-to-tone response.
- 5.12Presence and effects
Use clarity, texture, dehaze, vignette, halation and grain to adjust detail and finishing effects.
- 5.13Lens corrections
Use a lens profile or manual distortion adjustment to correct lens distortion before other edits.
- 5.14Repairing a photograph
Press Q to remove spots or paint longer repairs using source material from the same photograph.
- 5.15Focus peaking
Press K to highlight sharp edges in green in Loupe, Compare or Develop.
- 5.16Soft proofing
Preview a photograph in an export colour space and highlight colours that fall outside its range.
- 5.17Working with looks
Apply a look to give a photograph a starting treatment, then adjust its strength and individual settings.
- 5.18Composition review
The Composition panel helps you explore framing from your intention for the photograph.
- 5.19Versions
Save any number of versions of a photograph and switch between them or ORIGINAL in the version picker.
- 5.20Comparing versions
Version comparison shows a reference and the editing version through the same framing.
- 5.21Undo, RESET, bypass and copying
Use ⌘Z to undo edits, RESET to clear a group and bypass to preview a photograph without that group.
- 5.22An edit reaches Photos.app
Allow Photos publishing to send a full-resolution edited rendering to Apple Photos when you leave a changed photograph.
- 5.23How a RAW file becomes a picture
Frames selects the newest RAW decoder supported by each file and shows the adjustments that decoder provides.
Masking
14 featuresUse layers to apply adjustments to part of a photograph. Draw a mask, select colours or tones, or use detected subjects and objects. Refine individual shapes with colour and brightness selectivity, then soften the combined mask with Diffusion.
What it does
Mask layers
Apply adjustments through named layers with colour, visibility and opacity controls.
What a mask isDrawn masks
Draw Radial, Linear and Brush masks that remain aligned through crop and straighten.
Drawing a maskAI subject masks
Create layers from subjects, background, sky, people and objects detected on your Mac.
Masks the photograph offersPeople by part
Create separate or combined masks for available face parts, hair and clothes.
People, part by partHover to mask
Press M, hover over a detected object and click its highlight to create a mask layer.
Masks the photograph offersSelect tool
Click or draw a box to select an object, then click to include areas or ⌥-click to exclude them.
The Select toolSnapping brush
Enable Snap to include detected objects crossed by a brush stroke while retaining the painted line.
Drawing a maskMask components
Add, subtract, reorder or disable individual shapes within a mask layer.
Seeing the maskMask overlays
Press V to cycle hidden, tint, zebra and matte views of the selected mask.
Seeing the maskRange masks
Select a brightness band with Low, High and Falloff, or sample a colour and set its tolerance.
Range masksMask selectivity
Limit individual mask shapes to matching colour and brightness, including subtracting shapes.
Narrowing a mask to a colourMask diffusion
Soften the combined layer mask with Diffusion, alongside individual shape feather controls.
Narrowing a mask to a colour
Pages
- 6.1What a mask is
A mask defines where a layer’s adjustments apply.
- 6.2Drawing a mask
Press M and drag on the photograph to draw a Radial, Linear or Brush mask.
- 6.3Range masks
Create a mask from a brightness range or a selected colour.
- 6.4Narrowing a mask to a colour
Use Selectivity to limit a shape to matching colours and brightness, and Diffusion to soften the finished layer mask.
- 6.5Masks the photograph offers
Create masks from detected subjects, people, sky and foreground objects in Develop.
- 6.6People, part by part
Create masks for a person’s face, skin, eyes, eyebrows, lips, teeth, hair or clothes.
- 6.7The Select tool
Select and automatic Sky detection require macOS 27 or iOS/iPadOS 27.
- 6.8Seeing the mask
Press V to cycle the selected mask through hidden, tint, zebra and black-and-white matte views.
- 6.9Global adjustments and masks
Crop, Lens, RAW Detail and other whole-photograph controls cannot be applied through a mask.
Reference
17 featuresFind keyboard shortcuts, on-screen help, activity details, storage controls and command-line tools.
What it does
Shortcuts library actions
Find photographs, manage metadata, collections and versions, and save treatments with Apple Shortcuts.
Workflow automationShortcuts file processing
Process incoming image files and return exports without adding the inputs to the library.
Workflow automationShortcuts Develop actions
Set a Develop control, reset adjustments or set a crop with Apple Shortcuts, on the photograph open in Develop or on photographs a shortcut found.
Workflow automationAutomator and script workflows
Run named shortcuts from Automator, Finder Quick Actions and scripts on Mac.
Workflow automationSpotlight search
Find albums, Frames collections and the photographs you kept, rated, captioned or gave keywords from Spotlight. A chosen photograph opens in the loupe with your words in Frames’ search.
Spotlight, Siri and HandoffSiri collection phrases
Open or present a Photos album or a Frames collection by asking Siri.
Spotlight, Siri and HandoffHandoff
Continue with the photograph in the loupe or Develop on another device. When it has yet to reach that device, Frames says so and downloads nothing.
Spotlight, Siri and HandoffOwn catalogue
Frames stores its data locally and backs up the catalogue before schema migrations.
CatalogueMetadata backfill
Read missing camera, lens and exposure data from originals through the Photos source panel.
StorageKeyboard-first
Use shortcuts for reviewing and editing photographs, and press ? for contextual help.
The keyboardActivity queue
Track library, photograph and output work in one panel, with progress, errors and recent history.
What the application is doingProgressive loading
Photographs appear from available previews and improve as better renditions become ready.
The interface gets out of the wayManual in the app
Press ⌘? or choose Frames Manual from Help to open the bundled documentation.
The pointer, and the help overlayAccessible controls
Controls have accessibility labels, grouped star rows and phase announcements for VoiceOver.
The interface gets out of the wayrawctl
Import, inspect, render and troubleshoot through a command-line tool using the same catalogue.
rawctl
Pages
- 7.1The keyboard
Use keyboard shortcuts to switch modes and views, review photographs and edit.
- 7.2The pointer, and the help overlay
Press ? or choose Help › Help Overlay in the photograph window to show keyboard shortcuts and pointer gestures over that window.
- 7.3What the application is doing
Click the activity ring in the control band to see progress, errors and recently completed work.
- 7.4The interface gets out of the way
Frames uses a dark interface, adjustable panels and accessible controls around the photograph.
- 7.5Storage
Open Settings › Storage to inspect and clear the derived data cached across the catalogue.
- 7.6Catalogue
Frames stores ratings, verdicts, recipes and other catalogue data in SQLite and backs it up before schema migrations.
- 7.7Workflow automation
Build workflows that find and organise photographs, save versions and export files with Apple Shortcuts.
- 7.8Spotlight, Siri and Handoff
Find your albums, your collections and the photographs you have judged from Spotlight, and carry the photograph you are looking at to another device.
- 7.9rawctl
rawctl is Frames’ development driver for importing, inspecting, rendering and troubleshooting photographs from the command line.
No matches. Try a feature name, tool or task.