A Rawed+ használata MI-ügynökökkel

A Rawed+-hoz MCP-szerver is tartozik, a rawed-mcp, így az MI-ügynökök, például a Claude Code, a Claude Desktop és a Codex szerkeszthetik, válogathatják és exportálhatják a fotóit. Itt megtalálja a beállítás lépéseit, kéréspéldákat, az adatvédelem részleteit és az összes eszközt.

Követelmények

  • Rawed+ a 14 napos próbaidőszak alatt vagy licenccel. A Mac App Store-os Rawed nem enged hozzáférést az ügynököknek, de ugyanazon a Macen feloldja a Rawed+-t.
  • macOS 26 vagy újabb
  • Helyi MCP-szervert futtatni képes MI-ügynök, például Claude Code, Claude Desktop, Codex CLI vagy Cursor

Az ügynökök hozzáférésének bekapcsolása

Nyissa meg a Rawed+-t, válassza a Rawed+ › Beállítások menüpontot, kattintson az MI-ügynökök lapra, és kapcsolja be A Rawed használatának engedélyezése MI-ügynököknek lehetőséget. Ugyanezt a panelt nyitja meg a Súgó › A Rawed használata MI-ügynökökkel… menüpont is. Itt az alábbi parancsokat is látja, az alkalmazás Ön gépén lévő elérési útjával, valamint azt, hogy melyik ügynök csatlakozik.

Az ügynök csatlakoztatása

Az alábbi parancsok feltételezik, hogy a Rawed+ az Alkalmazások mappában van. Ha máshol van, másolja ki őket inkább a Beállítások › MI-ügynökök részből.

Claude Code

Futtassa ezt a parancsot a Terminálban. A --scope user az összes projektjében elérhetővé teszi a Rawedet. Utána indítson új Claude Code-munkamenetet.

claude mcp add --scope user rawed -- "/Applications/Rawed+.app/Contents/MacOS/rawed-mcp"

Claude Desktop

A Claude Desktopban válassza a Settings › Developer › Edit Config menüpontot. Ez megmutatja a claude_desktop_config.json fájlt, amely a ~/Library/Application Support/Claude mappában van. Adja hozzá az alábbi rawed bejegyzést; ha a fájlban már van mcpServers, azon belülre tegye. Mentse a fájlt, majd lépjen ki a Claude Desktopból, és nyissa meg újra.

{
  "mcpServers": {
    "rawed": {
      "command": "/Applications/Rawed+.app/Contents/MacOS/rawed-mcp"
    }
  }
}

Codex CLI

Futtassa ezt a parancsot a Terminálban:

codex mcp add rawed -- "/Applications/Rawed+.app/Contents/MacOS/rawed-mcp"

Vagy adja hozzá ezeket a sorokat a ~/.codex/config.toml fájlhoz:

[mcp_servers.rawed]
command = "/Applications/Rawed+.app/Contents/MacOS/rawed-mcp"

Cursor és más MCP-kliensek

Vegye fel a Rawedet helyi (stdio) MCP-szerverként. A Cursor (~/.cursor/mcp.json) és a legtöbb más kliens ezt a JSON-t fogadja:

{
  "mcpServers": {
    "rawed": {
      "command": "/Applications/Rawed+.app/Contents/MacOS/rawed-mcp"
    }
  }
}

Azoknak a klienseknek, amelyek csak parancsot kérnek, ezt az elérési utat adja meg:

/Applications/Rawed+.app/Contents/MacOS/rawed-mcp

A Rawed+-nak nem kell nyitva lennie. Amikor az ügynök először használ egy eszközt, a rawed-mcp a háttérben elindítja. Ha az ügynökök hozzáférése ki van kapcsolva, az eszközök olyan üzenettel válaszolnak, amely megmondja, hol lehet bekapcsolni.

Így működnek az eszközök

  • Minden eszköz, amely fotókon dolgozik, azok fájlútvonalát kapja meg. Semmi sem függ attól, mit mutat vagy mi van kijelölve a Rawedben, így az ügynök bármelyik fotón dolgozhat, amelyet meg tud nevezni, bármelyik mappában, előzetes megnyitás nélkül.
  • Minden szerkesztés egy lépés az adott fotó saját előzményeiben, és a fotó mellett, egy kis .rawed.json fájlban mentődik, akárcsak a saját szerkesztései. Az eredetik soha nem változnak. A lépést visszavonhatja a Rawedben, vagy az ügynök is visszavonhatja az undo eszközzel.
  • Az olvasó eszközök, például a get_analysis, a render_preview és az assess_photos, semmit sem módosítanak. Az értékelés és a jelölés soha nem töröl fotót, és memóriakártyára semmi sem íródik.
  • Az egyetlen vissza nem vonható módosítás egy saját előbeállítás törlése a manage_preset eszközzel.

Adatvédelem

Az ügynökök hozzáférése mindaddig ki van kapcsolva, amíg be nem kapcsolja. Ezután a Rawed+ csak az ugyanazon a Macen futó programoktól fogad kapcsolatot, egy helyi socketen át, amelyet csak az Ön felhasználói fiókja nyithat meg, és egy kulccsal, amely a hozzáférés minden bekapcsolásakor megváltozik. A hálózatról nem érhető el, és maga a Rawed semmit sem küld sehová.

Az ügynök viszont más kérdés. Amit az eszközökön keresztül elolvas, például a fotóadatokat (köztük a GPS-helyet, ha a fotón van ilyen), a méréseket és a kért előnézeti képeket (a hosszabb oldalon legfeljebb 2048 képpont), az a beszélgetés része lesz, és eljut az ügynök MI-szolgáltatójához, ugyanúgy, mint bármi, amit ott begépel. Hogy a szolgáltató hogyan kezeli, az a saját feltételeitől és adatvédelmi irányelveitől függ. Az az ügynök, amely önállóan is olvas fájlokat, mint a Claude Code, közvetlenül is elolvashatja a fotóit; ez az ügynök beállítása, nem a Rawedé.

Eszközök

Az alábbi 42 eszköz azokkal a leírásokkal és argumentumokkal, amelyeket az ügynökök kapnak. Az ügynökök ezt a szöveget angolul olvassák.

get_state Get app state

Csak olvas

What the app shows (for orientation only; no tool acts on it): mode (library/edit), open folder, selection, photo shown in the editor with its history, presets, settings clipboard, library sort/filter, editor view (tool, zoom, compare, overlays, selected mask), shown device, recent folders, running batch and preferences.

Nincs argumentum.

list_photos List photos

Csak olvas

Supported photos in a folder (by file name, regardless of the library's filter and sort), with file name, path, file type, rating, flag, color label, capture date, camera and whether edited. Does not change what the app shows.

Argumentumok
folder kötelezőstringAbsolute folder path

get_photo_info Photo info

Csak olvas

Metadata of a photo (camera, lens, exposure, capture date, dimensions, color profile, location, IPTC keywords; read-only), its rating/flag/label, RAW engine capabilities (decoder versions, supported controls, as-shot white balance, baseline exposure, whether a neural denoise model is installed), its edit history (labels and position, for jump_to_history / undo / redo), save status and whether it is shown in the editor.

Argumentumok
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

get_recipe Get edit recipe

Csak olvas

A photo's complete current EditRecipe as JSON (light, toneMapping, toneCurve, color, hsl, pointColors, colorGrading, presence, detail, optics, geometry, effects, masks, raw, whiteBalance). Values use Rawed units: exposure in EV, most sliders -100...100.

Argumentumok
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

get_analysis Analyse photo

Csak olvas

Image statistics of a photo: luminance percentiles, clipping, dynamic range (EV), top vs bottom brightness, noise risk.

Argumentumok
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

render_preview Render preview

Csak olvas

Render a photo with its current edits and return it as a JPEG image so you can see the result.

Argumentumok
max_sizeintegerLong edge in pixels (default 1024, max 2048)
originalbooleanRender the unedited original instead (default false)
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

list_presets List presets

Csak olvas

Presets with name, whether built in, and the setting groups each one changes.

Nincs argumentum.

open_folder Show folder

Csak olvas

Show a folder of photos in the library (File › Open Folder / Open Recent). View only: other tools take explicit paths and don't need it.

Argumentumok
path kötelezőstringAbsolute folder path

recent_folders Recent folders

Csak olvas

List File › Open Recent folders, or clear the list.

Argumentumok
clearbooleanClear the Open Recent menu

select_photos Select photos

Csak olvas

Change the library selection the user sees, like clicking in the grid: select paths, all or none, or step to the previous/next photo (Photo › Previous/Next Photo; in edit mode this shows it). View only: no tool acts on the selection.

Argumentumok
allbooleanSelect every visible photo
nonebooleanClear the selection
pathsarray (string)Photos to select (replaces the selection)
stepintegerMove by this many photos in library order (-1 previous, 1 next)

open_photo Show photo

Csak olvas

Show a photo to the user in the editor (also photos on a memory card or drive). View only: editing tools take the photo's path and work the same whether or not it is shown.

Argumentumok
path kötelezőstringAbsolute path of the photo

show_in_finder Show in Finder

Csak olvas

Reveal files or folders in Finder (Photo › Show in Finder). This brings Finder to the front.

Argumentumok
paths kötelezőarray (string)Files or folders to reveal

update_recipe Update edit recipe

Fotókat vagy fájlokat módosít

Deep-merge a partial EditRecipe into a photo, e.g. {"light": {"exposure": 0.3, "highlights": -40}}. Covers every inspector slider and toggle (light, tone curve points, HSL, color grading, effects, detail incl. noiseReduction.neural, optics, geometry angle/perspective/crop, RAW engine). Arrays (curve points, masks) replace the whole array; prefer edit_mask for masks and set_white_balance for white balance modes. Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
changes kötelezőobjectPartial EditRecipe to merge
labelstringHistory label shown in the app (optional)
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

auto_adjust Auto adjust

Fotókat vagy fájlokat módosít

Run statistical Auto (Photo › Auto Adjust / Auto Landscape) on a photo, from that photo's own statistics. Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
modestring
Egy ezek közül: standard, landscape
standard, or landscape (also for sunsets: protects the sky, lifts the foreground)
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

recover_dynamic_range Recover dynamic range

Fotókat vagy fájlokat módosít

Protect highlights and lift shadows from the photo's statistics. Repeating it on the same photo right after with another strength re-derives from the same base, like the inspector slider. Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.
strengthnumber0...100 (default 60)

apply_preset Apply preset

Fotókat vagy fájlokat módosít

Apply a preset by name. Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
name kötelezőstringPreset name (see list_presets)
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

set_white_balance White balance

Fotókat vagy fájlokat módosít

White balance: As Shot, Auto (estimated from the photo), Custom temperature/tint, or the eyedropper at a point that should be neutral. Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
modestring
Egy ezek közül: as_shot, auto, custom
White balance mode
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.
pickobject
x, y
Eyedropper point {"x": 0...1, "y": 0...1}, normalized in the uncropped, unrotated photo, top-left origin
temperaturenumberKelvin, 2000...12000 (custom)
tintnumber-150...150 (custom)

apply_tone_curve_preset Tone curve preset

Fotókat vagy fájlokat módosít

Set a point-curve channel to Linear, Medium Contrast or Strong Contrast. Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
channelstring
Egy ezek közül: rgb, red, green, blue
Channel (default rgb)
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.
preset kötelezőstring
Egy ezek közül: linear, medium_contrast, strong_contrast
Curve preset

transform Rotate, flip, crop ratio

Fotókat vagy fájlokat módosít

Geometry, one action per call: rotate 90° (resets the crop), flip, set the crop aspect ratio (centered crop) or reset all geometry. Straighten angle, perspective and the crop rectangle itself are update_recipe geometry values. Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
aspect_ratiostring"original", "free", or W:H such as "1:1", "4:3", "3:2", "16:9", "5:4"
flipstring
Egy ezek közül: horizontal, vertical
Flip
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.
resetbooleanReset Geometry
rotatestring
Egy ezek közül: left, right
Rotate 90° counterclockwise (left) or clockwise (right)

auto_straighten Auto straighten

Fotókat vagy fájlokat módosít

Level the horizon with horizon detection (Photo › Auto Straighten). Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

edit_mask Edit masks

Fotókat vagy fájlokat módosít

Local adjustment masks of the photo at path; one step in its history per call. Actions: add (new mask from one shape; optional name and adjustments), add_component (to mask_id, combined by operation), update_component (component_id: operation, inverted, or new shape parameters), remove_component, set (mask_id: name, enabled, amount 0...100, adjustments), delete, select (show it in the inspector; only for the photo shown in the editor). Shapes: linear_gradient {start, end} (full effect at start, fading to end); radial_gradient {center, radius_x, radius_y, feather}; brush {strokes: [{points: [[x,y],…], size (fraction of long edge, default 0.08), feather (60), flow (50), density (100), erase}]}; luminance_range {lower, upper (0...1), feather}; color_range {hue (degrees), hue_range, min_saturation (0...1), feather}; sky; subject. Points are {"x","y"} normalized 0...1 in the uncropped, unrotated photo, top-left origin. adjustments: exposure (EV), contrast, highlights, shadows, whites, blacks, temperature, tint, saturation, sharpness, clarity, dehaze (-100...100). Mask and component ids belong to that photo; see get_recipe {path}.masks.

Argumentumok
action kötelezőstring
Egy ezek közül: add, add_component, update_component, remove_component, set, delete, select
What to do
adjustmentsobjectLocal adjustments to merge, e.g. {"exposure": -0.5, "highlights": -40}
amountnumberMask amount 0...100
component_idstringComponent id (update_component, remove_component)
enabledbooleanMask on/off
invertedbooleanInvert the component
mask_idstringMask id of this photo (all actions except add)
namestringMask name
operationstring
Egy ezek közül: add, subtract, intersect
How a component combines with the previous ones (default add)
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.
shapeobjectShape for add / add_component / update_component: {"kind": linear_gradient|radial_gradient|brush|luminance_range|color_range|sky|subject, …parameters}

jump_to_history Go to history step

Fotókat vagy fájlokat módosít

Return a photo to a step of its own edit history, as clicking it in the History panel. No step is discarded: jump back to the previous history_position to return; undo / redo {path} step from the jumped-to step. Index 0 is the photo as it was when first edited or shown in this app session; see get_photo_info {path}.history.

Argumentumok
index kötelezőintegerHistory index
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

reset_all_edits Reset all edits

Fotókat vagy fájlokat módosít

Return every setting, the crop and all masks of a photo to its defaults as one step (Photo › Reset All Edits). Acts on the photo at path: one step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app. If the photo is the one shown in the editor, the user sees the change live; otherwise it is edited without changing what the app shows.

Argumentumok
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

undo Undo

Fotókat vagy fájlokat módosít

Undo the last edit step of the photo at path (made by you or the user), and only of that photo; other photos are never affected. Ratings, flags and labels are not part of a photo's edit history.

Argumentumok
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

redo Redo

Fotókat vagy fájlokat módosít

Redo the last undone edit step of the photo at path.

Argumentumok
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

set_rating Rate photos

Fotókat vagy fájlokat módosít

Set rating (0-5), flag and/or color label of photos as one step the user can undo in the app (Edit › Undo).

Argumentumok
color_labelstring
Egy ezek közül: none, red, yellow, green, blue, purple
Color label
flagstring
Egy ezek közül: none, pick, reject
Flag
paths kötelezőarray (string)Absolute paths of the photos to act on (any folder).
ratinginteger0...5

copy_settings Copy settings

Csak olvas

Copy a photo's settings to Rawed's settings clipboard for the user's Edit › Paste Settings. No tool reads this clipboard: paste_settings takes its source photo explicitly.

Argumentumok
categoriesarray
Lista ezekből: raw, whiteBalance, light, toneMapping, toneCurve, color, hsl, colorGrading, presence, detail, optics, geometry, effects, masks
Setting groups to copy (default: all except geometry, masks and raw)
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.

paste_settings Paste settings

Fotókat vagy fájlokat módosít

Copy settings from the photo at source to each photo in paths (Edit › Paste Settings / Paste Selected Settings): one step in each target photo's own history.

Argumentumok
categoriesarray
Lista ezekből: raw, whiteBalance, light, toneMapping, toneCurve, color, hsl, colorGrading, presence, detail, optics, geometry, effects, masks
Setting groups to paste (default: all except geometry, masks and raw)
paths kötelezőarray (string)Absolute paths of the photos to paste into
source kötelezőstringAbsolute path of the photo whose settings are copied

manage_preset Manage presets

Végleg törölhet egy előbeállítást

Create a preset from the settings of the photo at path, rename, delete (user presets only; cannot be undone), import a .rspreset file, or export a preset to a file.

Argumentumok
action kötelezőstring
Egy ezek közül: create, rename, delete, import, export
What to do
categoriesarray
Lista ezekből: raw, whiteBalance, light, toneMapping, toneCurve, color, hsl, colorGrading, presence, detail, optics, geometry, effects, masks
Groups the new preset stores (create; default: the edited groups except geometry, masks and raw)
namestringPreset name (new name for create; existing preset otherwise)
new_namestringNew name (rename)
pathstringPhoto whose settings the new preset stores (create, required), file to import, or file/folder to export to

export Export

Végleg törölhet egy előbeállítást

Export photos with their current edits, and wait until done (File › Export…). Starts from Rawed defaults, not the Export sheet's last settings: Full-Size JPEG (JPEG 90%, original size, sRGB, all metadata, "{name}", next to the original); quick_convert is the same with the sheet's last settings. Sources on memory cards or in folders that can't be written require a directory argument; no files are written until a usable destination is provided. A directory on a memory card is rejected. Does not change the Export sheet's remembered settings. on_conflict decides what happens when a file with the output name already exists; a name that is one of the exported photos, or that two photos would share, is numbered instead. Returns the written paths and the number of skipped photos.

Argumentumok
color_spacestring
Egy ezek közül: sRGB, displayP3
Color space (default sRGB)
copyrightstringCopyright notice written to the file (TIFF, IPTC) unless metadata is none; empty keeps the original's
creatorstringCreator written to the file (TIFF Artist, IPTC By-line) unless metadata is none or copyright_only; empty keeps the original's
directorystringDestination folder; required if any source folder can't be written or is on a memory card. Omit only to save next to writable originals.
file_namestringFile name template: {name} = original name, {index} = number in the export (3 digits), {seq:N} = number with N digits, {date} = capture date (yyyy-MM-dd) (default {name})
formatstring
Egy ezek közül: jpeg, heif, png, tiff
File format (default jpeg)
heightintegerfit_within height
include_metadatabooleanOlder switch, same as metadata: false = none
long_edgeintegerPixels for long_edge
lookstring
Egy ezek közül: edits, original
With the photo's edits (default; photos without edits keep the camera look), or as shot
megapixelsnumberTotal pixel count in millions for megapixels, keeping the aspect ratio (never upscales)
metadatastring
Egy ezek közül: all, all_except_location, all_except_camera_and_location, copyright_only, none
Metadata kept from the original: everything, without GPS, also without camera and lens (make, model, serial numbers), only the copyright, or nothing. TIFF Software = Rawed is always written
on_conflictstring
Egy ezek közül: replace, keep_both, skip
When the file already exists: replace it, keep both (writes <name>-2.<ext> …), or skip the photo (default keep_both). Only files Rawed wrote are replaced; any other file (an original such as a camera JPEG) is kept and the export gets <name>-2.<ext>
output_sharpeningstring
Egy ezek közül: none, screen, matte, glossy
Sharpening after resizing, for a screen or for printing on matte or glossy paper
paths kötelezőarray (string)Absolute paths of the photos to act on (any folder).
percentagenumberPercent of the size for percentage
presetstring
Egy ezek közül: full_jpeg, web, share, small, lossless
Start from a preset: Full-Size JPEG (JPEG 90%), Web (JPEG 2048 px 80%), Share (HEIF 50%), Small (JPEG 1280 px), Lossless PNG; the other options override it
qualitynumber0...1 for JPEG/HEIF (default 0.9)
remove_locationbooleanOlder switch, same as metadata: true = all_except_location
resolution_ppiintegerPixels per inch written to the file (no resampling); 0 keeps the original's
sharpening_amountstring
Egy ezek közül: low, standard, high
Output sharpening amount (default standard)
short_edgeintegerPixels for short_edge
sizestring
Egy ezek közül: original, long_edge, short_edge, fit_within, percentage, megapixels
Size mode (default original; long_edge if only long_edge is given)
subfolderstringCapture-date subfolder in a date format, e.g. "yyyy-MM-dd" or "yyyy/MM" (/ nests folders); "" or "none" for none
watermarkobject
color, font, image, margin, opacity, position, size, text, type
Watermark drawn into the exported files only (not into the photo, the editor or Save as JPEG), after resizing. type is required; the other options left out keep the current watermark's (quick_convert: the Export sheet's last one) or the defaults. {"type": "none"} removes it
widthintegerfit_within width

save_jpeg Save as JPEG

Végleg törölhet egy előbeállítást

Save photos with their current edits as full-size JPEGs next to the originals (File › Save as JPEG) and wait until done: <name>.jpg, sRGB, quality 90, metadata kept (location removed only when the Export sheet's Remove Location or no-metadata choice says so). A JPEG original, or a photo whose <name>.jpg is a file Rawed didn't write (such as the camera JPEG of a RAW + JPEG pair), gets <name> edited.jpg instead. Originals and their edit files are never changed. on_conflict decides what happens when that JPEG already exists. Photos on memory cards or in folders that can't be written fail (use export with a directory). Returns the written, skipped and failed paths.

Argumentumok
on_conflictstring
Egy ezek közül: replace, keep_both, skip
When the JPEG already exists: replace it, keep both (writes <name> 2.jpg …), or skip the photo (default keep_both)
paths kötelezőarray (string)Absolute paths of the photos to act on (any folder).

quick_convert Quick Convert

Fotókat vagy fájlokat módosít

Alias of export that starts from the Export sheet's last settings (File › Export…) instead of Rawed defaults, also takes folders, and never asks: an existing file is kept and the new one numbered (<name>-2.<ext>). Without saved settings it starts at Full-Size JPEG (JPEG 90%, original size; earlier versions started at Web). A preset and the other options override them. Sources on memory cards or in folders that can't be written require a directory argument; no files are written until a usable destination is provided. A directory on a memory card is rejected. Returns the written paths.

Argumentumok
color_spacestring
Egy ezek közül: sRGB, displayP3
Color space
copyrightstringCopyright notice written to the file (TIFF, IPTC) unless metadata is none; empty keeps the original's
creatorstringCreator written to the file (TIFF Artist, IPTC By-line) unless metadata is none or copyright_only; empty keeps the original's
cropstring
Egy ezek közül: none, 1:1, 4:3, 3:2, 16:9
Centered crop (follows each photo's orientation)
directorystringDestination folder; required if any source folder can't be written or is on a memory card. Omit only to save next to writable originals.
file_namestringFile name template: {name} = original name, {index} = number in the export (3 digits), {seq:N} = number with N digits, {date} = capture date (yyyy-MM-dd) (overrides suffix)
formatstring
Egy ezek közül: jpeg, heif, png, tiff
File format
heightintegerfit_within height
include_metadatabooleanOlder switch, same as metadata: false = none
long_edgeintegerPixels for long_edge
lookstring
Egy ezek közül: edits, original
With the photo's edits, or as shot
megapixelsnumberTotal pixel count in millions for megapixels, keeping the aspect ratio (never upscales)
metadatastring
Egy ezek közül: all, all_except_location, all_except_camera_and_location, copyright_only, none
Metadata kept from the original: everything, without GPS, also without camera and lens (make, model, serial numbers), only the copyright, or nothing. TIFF Software = Rawed is always written
output_sharpeningstring
Egy ezek közül: none, screen, matte, glossy
Sharpening after resizing, for a screen or for printing on matte or glossy paper
paths kötelezőarray (string)Photos or folders to convert
presetstring
Egy ezek közül: full_jpeg, web, share, small, lossless
Full-Size JPEG (JPEG 90%), Web (JPEG 2048 px 80%), Share (HEIF 50%), Small (JPEG 1280 px), Lossless PNG
qualitynumber0.3...1 for JPEG/HEIF
remove_locationbooleanOlder switch, same as metadata: true = all_except_location
resolution_ppiintegerPixels per inch written to the file (no resampling); 0 keeps the original's
sharpening_amountstring
Egy ezek közül: low, standard, high
Output sharpening amount (default standard)
short_edgeintegerPixels for short_edge
sizestring
Egy ezek közül: original, 50%, 25%, long_edge, short_edge, fit_within, megapixels
Size
subfolderstringCapture-date subfolder in a date format, e.g. "yyyy-MM-dd" or "yyyy/MM" (/ nests folders); "" or "none" for none
suffixstringAppended to the original name, e.g. "-web" (sets file_name to {name}-web)
watermarkobject
color, font, image, margin, opacity, position, size, text, type
Watermark drawn into the exported files only (not into the photo, the editor or Save as JPEG), after resizing. type is required; the other options left out keep the current watermark's (quick_convert: the Export sheet's last one) or the defaults. {"type": "none"} removes it
widthintegerfit_within width

merge_hdr Merge to HDR

Fotókat vagy fájlokat módosít

Merge bracketed photos (at least two, in the given order) into a linear HDR TIFF next to the first one when its folder is writable, and show it in the editor (Photo › Merge to HDR). Pass directory when the first photo is on a memory card or its folder can't be written. Waits until done and returns the merged file's path.

Argumentumok
alignbooleanAlign the frames (default true)
deghostingnumber0...1 moving-object suppression (default 0.5)
directorystringDestination folder; required if the first photo's folder can't be written or is on a memory card.
paths kötelezőarray (string)Bracketed photos

list_devices List devices

Csak olvas

Connected memory cards and external drives.

Nincs argumentum.

show_device Show device

Csak olvas

Show a memory card or drive in the library (sidebar › Devices) and wait for the photo scan, or close it. Returns the photos grouped as in the gallery (RAW + JPEG pairs are one item).

Argumentumok
closebooleanClose the device and return to the folder
filterstring
Egy ezek közül: all, raw, jpeg
Show all photos, or only RAW / JPEG
pathstringVolume path from list_devices (default: the device already shown)

copy_from_device Copy to folder

Fotókat vagy fájlokat módosít

Copy photos from a memory card or drive to a folder on the Mac (File › Copy to Folder) and wait until done. Shows the device in the library while it is scanned. Nothing on the card is changed.

Argumentumok
by_datebooleanPut photos in folders by capture date (default true)
destination kötelezőstringDestination folder
device kötelezőstringVolume path from list_devices
pathsarray (string)Photos to copy (any file of a RAW + JPEG pair copies both; default: every photo on the device)
skip_existingbooleanSkip photos that were already copied (default true)

eject_device Eject device

Fotókat vagy fájlokat módosít

Eject a memory card or drive (File › Eject).

Argumentumok
path kötelezőstringVolume path from list_devices

set_view Control the view

Csak olvas

Operate the GUI without changing photos: mode, editor tool, zoom, before/after, clipping overlays (highlights, shadows, zebra, heatmap, threshold), EDR preview, sharpening mask, mask overlay and selected mask, inspector and filmstrip visibility, inspector tab, library sort and filter, thumbnail size.

Argumentumok
clear_filterbooleanClear the library filter
clippingbooleanShow both highlight and shadow clipping
comparestring
Egy ezek közül: off, split, side_by_side
Before/after
extended_dynamic_rangebooleanEDR preview on HDR displays
filmstripbooleanShow the filmstrip
filter_file_typestring
Egy ezek közül: all, raw, jpeg, heif, png, tiff
Library file type filter
filter_flagstring
Egy ezek közül: any, pick, reject, unflagged
Library flag filter
filter_ratingintegerShow photos with at least this many stars (0 = any)
heatmapbooleanExposure heatmap
highlight_clippingbooleanShow highlight clipping
inspectorbooleanShow the inspector
inspector_tabstring
Egy ezek közül: adjust, presets, history
Inspector tab
mask_overlaybooleanShow the selected mask as an overlay
modestring
Egy ezek közül: library, edit
App mode (edit opens the focused photo)
selected_maskstringMask id to select in the inspector
shadow_clippingbooleanShow shadow clipping
sharpening_maskbooleanShow the sharpening mask
show_originalbooleanShow the original instead of the edit (like holding Space)
sortstring
Egy ezek közül: capture_time, file_name, rating
Library sort order
thresholdstring
Egy ezek közül: 95, 98, 100
Highlight warning threshold in percent
thumbnail_sizeintegerLibrary thumbnail size in points, 110...320
toolstring
Egy ezek közül: none, crop, mask, white_balance, color_target
Editor tool (color_target: the Point Color eyedropper / targeted adjustment)
zebrabooleanZebra stripes above the threshold
zoomstring"fit", "fill", a percentage 5...800 (e.g. "100"), "in" or "out"

set_preferences Preferences

Csak olvas

Rawed Settings › Editing defaults for newly opened photos.

Argumentumok
extended_dynamic_rangebooleanUse the EDR preview on HDR displays by default
highlight_warning_thresholdstring
Egy ezek közül: 95, 98, 100
Default highlight warning threshold in percent

edit_point_color Point Color

Fotókat vagy fájlokat módosít

Point Color (Color panel): change one color picked in the photo — its hue, saturation and luminance — without masks; every pixel close to that color changes, with a smooth falloff. Actions: add (sample the color at `sample`, or give `color`), update (point_id: any of the values below), delete (point_id), move (point_id, offset -1 earlier / 1 later; points apply in order). Values: hue_shift, saturation, luminance (-100...100; luminance 100 = +1 EV on that color), range (0...100, default 50: how far from the color the change reaches), hue_range, saturation_range, luminance_range (0...100, default 50: refine the range per dimension), enabled. `color` is {"lightness", "chroma", "hue"} in OKLCh of the linear working space, or {"hex": "#RRGGBB"} (sRGB). Point ids and targets are in get_recipe.pointColors. One step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app; if the photo is shown in the editor the user sees it live.

Argumentumok
action kötelezőstring
Egy ezek közül: add, update, delete, move
What to do
colorobjectTarget color for add: {"lightness", "chroma", "hue"} (OKLCh) or {"hex": "#RRGGBB"}
enabledbooleanPoint color on/off
hue_rangenumber0...100 (default 50)
hue_shiftnumber-100...100 (±30° hue rotation)
luminancenumber-100...100 (±1 EV)
luminance_rangenumber0...100 (default 50)
offsetintegermove: -1 earlier, 1 later
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.
point_idstringPoint color id (update, delete, move)
rangenumber0...100 (default 50)
sampleobject
x, y
Point {"x": 0...1, "y": 0...1}, normalized in the uncropped, unrotated photo, top-left origin (as for masks and the white balance picker)
saturationnumber-100...100
saturation_rangenumber0...100 (default 50)

targeted_adjust Targeted adjustment

Fotókat vagy fájlokat módosít

Change the color at a point of the photo, like dragging up or down on it with the targeted adjustment tool: target color_mixer changes the Color Mixer (HSL) bands of that color, weighted as the mixer blends them; target point_color changes the point color that covers that color, adding one sampled there if there is none. `amount` is in slider units (-100...100), added to the current values. Gray colors can't be changed in the Color Mixer. One step in that photo's own edit history (undo with undo {path}), saved next to the photo like an edit in the app; if the photo is shown in the editor the user sees it live.

Argumentumok
amount kötelezőnumber-100...100 slider units (positive = like dragging up)
path kötelezőstringAbsolute path of the photo to act on (any folder). Whether or not it is shown in the editor makes no difference.
point kötelezőobject
x, y
Point {"x": 0...1, "y": 0...1}, normalized in the uncropped, unrotated photo, top-left origin (as for masks and the white balance picker)
property kötelezőstring
Egy ezek közül: hue, saturation, luminance
Which property changes
target kötelezőstring
Egy ezek közül: color_mixer, point_color
What changes

assess_photos Assess photos for culling

Csak olvas

Measure photos for culling; read-only (nothing is edited, rated or saved). Each photo is measured on a 1024 px sRGB image: RAW files on the camera's embedded preview (as shot, before edits; get_analysis measures the RAW data itself), other files downsampled. Per photo: sharpness — variance of the Laplacian (after a light 3×3 pre-blur) over the frame (global) and in its sharpest 5 % (local, so a sharp subject on a soft background counts as sharp), score 0–100 (log scale, local 5 → 0, 500 → 100), likely_blurry when local < 15 (conservative: mildly soft frames of detailed scenes pass; in a duplicate group compare relative_to_group_best, softer_than_group below 0.5); exposure as shot — highlight_clip_percent (any channel ≥ 250/255), shadow_clip_percent (all ≤ 5/255), ev_offset (mean EV of the frame vs. 18 % gray), likely_overexposed (ev_offset > 1 or > 5 % clipped), likely_underexposed (ev_offset < −2.5 or > 20 % crushed); low-key and high-key scenes can be flagged on purpose; faces (Apple Vision) — count, box (0…1, top-left origin), capture_quality 0…1 (compare the same person across frames), eye openness (height/width of the landmark eye contour; open ≈ 0.25–0.45) and eyes_closed when both are below 0.18 — a heuristic: null for faces under 48 px wide or without landmarks, unreliable for profiles, sunglasses, squinting or looking down. Near-duplicates across the given photos: Vision feature print distance (revision 2, on a 224 px copy) ≤ duplicate_threshold (default 0.6; re-encoded copies ≈ 0.1, different scenes ≈ 1.2), complete linkage (every pair in a group is within the threshold), with suggested_keep per group (no closed eyes, then sharpest, then best face quality, then least clipping) and each photo's nearest match. Thresholds are repeated in the reply. Unreadable files are listed under failures.

Argumentumok
duplicate_thresholdnumberFeature print distance up to which photos are near-duplicates (default 0.6)
includearray
Lista ezekből: sharpness, exposure, faces, duplicates
Measurements to make (default all). duplicates compares the photos with each other.
paths kötelezőarray (string)Absolute paths of the photos to measure and compare (any folders; up to 500)