External Cameras#
CaptureGraph can import photos and videos into a capture step from a DSLR or mirrorless camera connected to the iPhone or iPad by cable, or from the phone's photo library. The phone's viewfinder stays the main way to capture; an Import button over the viewfinder drops the import panel over it, and the panel drops by itself when a camera is plugged in. Selecting a shot puts it in the step, and deselecting it takes it back out; a camera that reports new shots also imports each one as you take it.
Why Import from a Camera#
Photos from DSLR and mirrorless cameras are common in research datasets, but in smaller quantities than phone photos, largely because organising them is hard. A day of shooting leaves hundreds of files on a card, and matching each one to its subject, session, and conditions is manual work done after the fact. Importing into the step removes that work: each shot lands in the procedure step that asked for it, in the session's schema layout, next to the time, location, and answers the procedure records with it.
Supported Steps#
| Step | Imports |
|---|---|
CaptureImage |
The selected photo goes up for confirmation and enters the step when you keep it; selecting another replaces it. |
CaptureImageSequence |
Every selected photo joins the sequence. |
CaptureImagesByLabel |
Pick a label in the viewfinder's bottom bar; photos import into that label until you pick another (Labels). |
CaptureVideo |
The selected movie goes up for confirmation and enters the step when you keep it; selecting another replaces it. |
CapturePanorama, CaptureFlashNoFlash, CaptureConstantColorImage, CaptureAlignedImage, and the ARKit steps always use the phone's camera, because they depend on the phone's own motion sensors, flash, screen, or AR tracking.
Setup#
The photo library needs no setup: the first time you show it in the import panel, iOS asks for access to your photos. For a camera:
- Connect the camera directly. On a USB-C iPhone or iPad, use a USB-C to USB-C cable. On a Lightning iPhone, use Apple's Lightning to USB 3 Camera Adapter with the camera's USB cable; Fujifilm, Sony, and Ricoh state that a plain USB-C to Lightning cable does not work. Avoid hubs.
- Turn off the camera's Wi-Fi, Bluetooth, and smartphone remote features. Some cameras stop communicating over USB while a wireless connection is active.
- Set the camera's USB mode to a PTP, MTP, or card-reader mode. See Camera Settings by Brand.
- Turn off USB power supply or USB charging on the camera. A USB-C iPhone supplies up to 4.5 W to accessories, and a camera that charges from it drains the phone's battery. On Lightning, if iOS reports that the accessory needs too much power, connect a charger to the adapter's Lightning port.
- Set the camera's auto power off to its longest value if you shoot while it is connected. A camera that turns itself off closes the connection, and nothing imports until it reconnects.
- Record RAW and JPEG to the same card, if the camera saves both. Some cameras expose only one card slot over USB.
- Set the camera's date and time. The import panel sorts and labels shots by the capture time in their metadata, which comes from the camera's clock.
- Unlock the phone, then plug in the camera. iOS does not open a data connection to an accessory that is connected while the phone is locked. Approve the accessory prompt if iOS shows one (in iOS 26 this is governed by Settings → Privacy & Security → Wired Accessories).
- Allow access when CaptureGraph asks. CaptureGraph asks for access to the files on connected cameras the first time a camera connects, and for a camera in a PTP or MTP mode it may also ask to control the camera. Without control, the camera may not report new shots.
- Wait for the status pill to turn green, then open a supported step and take a test shot.
The External Camera section under Settings → Camera Settings holds the feature's settings:
- Import from External Cameras (on by default). Turn it off and CaptureGraph stops looking for USB cameras; the Import button and the photo library stay available.
- Allow Access appears while access to camera files has not been asked for. It asks without a camera connected; use it if a camera does not appear until access is granted. Once access is allowed, the row reads Allowed. If access was declined, the row reads Allow Access in Settings and opens CaptureGraph's page in the iOS Settings app.
Camera Settings by Brand#
Check with a test shot
These menu names come from the manuals for the models named. They may vary by model and firmware. Whether a camera can shoot while connected, and whether it reports shots taken while connected, also varies by brand and USB mode, so take a test shot after any change.
In a PTP or MTP mode, try live import first. A card-reader (mass-storage) mode always uses plug to sync, because the camera cannot shoot while the phone reads its card.
| Brand | USB mode | Also set | Notes |
|---|---|---|---|
| Canon EOS | Choose USB connection app → Photo Import/Remote Control (R6 Mark II, R6 Mark III). Not "Canon app(s) for iPhone", which serves Canon's own apps. Earlier bodies without this menu use PTP by default. | Turn Wi-Fi off. | CaptureGraph puts the camera in remote mode, so it shoots from its own shutter while connected and each shot imports live. The R5 manual states that the camera cannot communicate over USB while a Wi-Fi connection is established. |
| Nikon Z | USB (Z9) or USB data connection (Z8) → MTP/PTP. Not "iPhone", which serves Nikon's own app and disables network functions. | USB connection priority → Shooting (Z6III). Turn USB Power Delivery off. | On the Z8, use the data port, not the power-delivery port. |
| Sony Alpha | USB Connection Mode → MTP (Image Transfer), or Mass Storage (MSC) with plug to sync. | Ctrl w/ Smartphone → Off, USB Power Supply → Off, USB LUN Setting → Single. | In MTP mode only the card in slot 1 is visible. Mass Storage mode blocks shooting while connected. PC Remote uses Sony's own protocol, which CaptureGraph does not use. |
| Fujifilm X / GFX | Connection Mode → USB Card Reader, with plug to sync. | USB Power Supply/Comm Setting → Power Supply Off/Comm On (the X-T5 manual requires this for iPhone). | The camera cannot shoot while connected in card-reader mode. The USB tether modes use Fujifilm's own protocol, which CaptureGraph does not use; in tether "Fixed" mode the camera does not write shots to the card by default. |
| Leica M11, Q3, SL2, SL3 | USB Mode → PTP. The M11's factory default, "Apple MFi", serves Leica's own app. | The M11 has internal memory as well as an SD card. | |
| Ricoh GR / Pentax | GR III, IIIx, IV: connect in MTP/PTP mode. K-3 III: MTP. | ||
| OM System / Olympus | Storage or MTP, with plug to sync. | The manual states that camera functions cannot be used while connected in Storage or MTP mode. The RAW/Control mode uses OM's own tethering protocol. | |
| Panasonic Lumix | PC(Storage), with plug to sync. | PC(Storage) is a card-reader mode. PC(Tether) uses Panasonic's own protocol, which CaptureGraph does not use. | |
| Sigma fp, fp L | Mass Storage, with plug to sync. | Camera Control uses Sigma's own protocol, which CaptureGraph does not use. |
For another brand, choose the camera's PTP or MTP mode if it has one, or its card-reader mode, and take a test shot.
Importing#
In a supported step, the Import button sits over the viewfinder's top-right corner, styled like the settings button at its bottom-right. It drops the import panel down over the viewfinder, the way the settings drawer rises from the bottom, and stays put as the end of the panel's top row; tap it again, or swipe the panel up, to put it away. A swipe down on the viewfinder also drops the panel. The panel drops by itself when you open the step with a camera connected, or plug one in while the viewfinder is up.
While the panel is down, the viewfinder pauses on its last frame and dims, and the phone's shutter is greyed out: nothing is captured with the phone in this mode. The bottom bar stays usable otherwise, including the label chips of CaptureImagesByLabel.
The sources are chips along the panel's top row: iPhone (the phone's photo library and its own captures), then each connected camera with a camera icon and, on multi-shot steps, the number selected from it. With no camera connected, a greyed USB Camera chip stands in: plug one in and it takes its place and is shown. Tap a chip to show its source. The panel opens on the camera plugged in last, else on the iPhone. Every source shows the same thing: a grid of its shots (Picking Shots). Tap a shot to select it; tap it again to deselect it.
Imports are queued, one at a time. A selected shot shows a spinner until it arrives, the panel shows which file is importing and how many shots are waiting, and the phone vibrates once as each import completes. A shot that fails to import stays selected with a red warning mark, and the app reports the error. Most iPhones transfer at USB 2 speed, and the Pro models that support USB 3 need a USB 3 cable to reach it, so large RAW files and movies take noticeably longer than JPEGs.
While the viewfinder is open, the step holds exactly the selected shots: those from every source and those taken with the phone's shutter. Steps that take several shots get each one as soon as it is on the phone, in the order you selected them, so an interrupted session keeps them. Deselecting a shot takes it out of the step, but its copy stays on the phone until the viewfinder closes, so selecting it again is instant.
Closing the viewfinder stops importing. CaptureGraph never deletes or changes a file on the camera's card: the card keeps every shot, imported or not.
Steps that take one photo or video (CaptureImage, CaptureAlignedImage, CaptureVideo) end on a confirmation screen rather than closing at the shutter: the shot, from the phone's shutter or the panel, shows in the viewfinder under Confirm Photo? or Confirm Video?, and nothing enters the step until you decide. The green ✓ puts the shot in the step and closes the viewfinder; the red ✕ leaves the step as it was and returns to the live camera, and the shot stays in the panel, unselected. A newer shot replaces the one waiting. A video plays muted; tap it for sound.
For CaptureVideo, set the camera to record MP4 or MOV: the video type accepts .mp4 and .mov files. The movie is imported as the camera recorded it, so the camera's own settings decide its resolution, frame rate, and dynamic range.
Live Import#
A camera is live when it reports each new shot: a Canon EOS body in a PTP mode (CaptureGraph turns on its remote mode), or any camera in a PTP or MTP mode that reports a new shot. A camera that reports nothing is a library until its first reported shot. On a live camera each shot imports moments after you take it, with the panel up or away, and appears selected at the top of the grid, above the Live divider and its pulsing green dot. Deselect it to take it back out of the step: it stays in the grid, and selecting it again puts it back without downloading it again. Nothing older is imported unless you select it.
While a live camera is shown, the screen stays awake, and when the proximity sensor is covered the display turns off and imports continue. Pocket Mode, beside the Live divider, darkens the whole screen and ignores touches, so the phone can be carried with the screen on; imports and their vibration continue. Double-tap to wake.
Picking Shots#
The grid holds every shot of the source, newest at the top, in sections. Under each section a divider names when it starts, as round a time as fits: Tuesday rather than "Tuesday 5 AM", 12 PM rather than "11:34". Dividers sit at:
- Live (with a green dot): shots a live camera took since the viewfinder opened, and on the iPhone the photos and videos taken with the phone's shutter; deselecting one takes it out of the step and leaves it in the grid. Grey squares end every partial row, and in Live mark where new shots land.
- Opened: shots a camera that is not live gained since the viewfinder opened.
- The longest pauses in shooting, found from the gaps between shots.
- Last import: the shots newer than the last import from this source, added to the divider's time ("Tuesday · Last import").
- Each midnight of the past week, counted back from the newest shot's day; "today" is that day.
- All, under the oldest shot.
Neither the dividers nor their labels compare the camera's clock with the phone's.
For CaptureImageSequence and CaptureImagesByLabel, each divider has a checkbox: checking it selects every shot above it, and unchecking it clears its own section. For CaptureImage and CaptureVideo, a tap selects one shot and deselects the other. Shots an earlier import took are dimmed and marked with a grey check; select one to import it again. While a source connects, lists its shots, or needs attention, the grid's place shows one centered line with the one action that helps (Settings or Retry).
CaptureGraph remembers the last import from each source across launches: per camera, by the serial number the camera reports (else by its name and USB IDs), and once for the photo library. The time compared is the camera's clock, so changing the clock moves the Last import divider.
The photo library lists the newest 1000 photos and videos, downloads originals from iCloud when needed, and is never changed by an import. With limited photo access, only the photos you allowed are listed.
Labels#
In CaptureImagesByLabel, the labels in the viewfinder's bottom bar are numbered, and each selected shot wears its label's number and colour. A tap on a shot that is not selected selects it into the label picked in the bottom bar; a tap on a shot in another label moves it to the picked label; a tap on a shot in the picked label deselects it.
Plug to Sync#
Plug to sync is for cameras that cannot shoot while plugged in, which includes every card-reader mode and many Fujifilm bodies:
- Connect the camera and wait for the pill to turn green, so CaptureGraph has read the card.
- Unplug the camera and shoot.
- With the step's viewfinder open, plug the camera back in. Once its card is read, every shot taken since the camera was last connected imports.
This works while CaptureGraph runs. Shots the card gained while the app was closed, or while no capture step was open, do not import on their own: select them above the Last import divider.
With plug to sync, every shot on the card reaches the phone at the same moment, so CaptureImagesByLabel imports all of them into the label selected when the card is read.
RAW or JPEG#
When the camera saves a RAW and a JPEG (or HEIF) file for the same shot, the step keeps one of them:
- RAW when the step's
encodinginput isImageEncoding.RAWand Settings → Camera Settings → RAW Photos → Enable RAW Photos is on. - JPEG or HEIF otherwise.
When the camera saves only one file per shot, that file is used as it is, whatever the step's encoding. The RAW file keeps the camera's own format (.cr3, .nef, .arw, and so on); CaptureGraph does not convert it.
The image type, cg.Image, accepts these extensions: heic, dng, jpeg, jpg, png, heif, hif, cr3, cr2, nef, nrw, arw, raf, orf, rw2, pef, 3fr, iiq, and rwl. When the preferred file of a pair is in a format not on this list, the step imports the other file and shows a warning. When no file of the shot is on the list, nothing is imported, the shot stays on the camera, and the app reports an error.
Files of the other media kind, such as a movie taken during a photo step or a photo taken during a video step, are ignored and stay on the camera.
Older Procedures and Servers#
The app takes cg.Image's extensions from its own type table, not from the procedure JSON. Procedures serialized before cg.Image accepted camera RAW and HEIF, local targets created from them, and the procedures bundled with the app all accept these formats without being republished.
A server-hosted target also needs the server to run the updated library: an older server rejects uploads of these files. Update CaptureGraph on the server and restart it before you collect camera RAW or HEIF files for one of its targets.
If the Phone Locks or the Camera Disconnects#
iOS pauses communication with the camera while CaptureGraph is not in the foreground, which includes while the phone is locked. Shots you take meanwhile stay on the card. When you return to the app with the viewfinder open, CaptureGraph reads the card again and imports every file it has not seen. The camera's clock plays no part in this: CaptureGraph compares the files on the card, not their timestamps.
When the cable is pulled, or the camera turns itself off and disappears from the phone, plug it back in: what was shot in between imports once the card is read, as in plug to sync. Unlock the phone before reconnecting, since iOS does not open a data connection to a camera connected while the phone is locked.
When the camera closes the connection but stays attached, the pill turns red and the panel shows the problem with Retry (Troubleshooting).
Geotagging#
When Settings → Camera Settings → Geotagging → Enable Geotagging Photos is on, CaptureGraph writes the phone's location into an imported photo only when all of these hold:
- The file is a JPEG or HEIF.
- The shot was imported live, as you took it. The location is the phone's position a moment after the shutter fired.
- The file carries no GPS position of its own. A file the camera has already geotagged keeps its own position.
- Writing the location loses none of the file's other metadata, such as the camera maker's notes. Otherwise the file is stored unchanged.
RAW files, DNG included, are stored unchanged: iOS cannot write location into them. Shots imported after the fact get no location: shots selected from the grid, and shots caught up after the phone was locked, after CaptureGraph was in the background, or after the camera reconnected. If location matters for those shots, record it in the procedure with cg.CaptureLocation.
The Status Pill#
While a camera is connected, a small pill sits at the bottom edge of the screen, over the charging port:
| Colour | Meaning |
|---|---|
| Grey | Connecting, or reading the card. With thousands of files on the card this can take from half a minute to several minutes; an emptier card connects faster. The panel shows how far the reading has got. |
| Green | Ready, in any USB mode including card-reader mode. |
| Red | A problem: access to the camera's files was declined, the connection could not be opened, or the camera closed it. The panel shows the problem with Retry, or with Settings when access was declined. |
There is no pill when no camera is connected, including while a camera is unplugged to shoot, or when Import from External Cameras is off.
Troubleshooting#
| What you see | Cause | Fix |
|---|---|---|
| No Import button in the viewfinder | The step does not support importing. | Use a supported step. |
| Red pill: no access to camera files | Access to the files on connected cameras was declined. iOS 18.0 declines without asking. | Tap Settings in the import panel (or Allow Access in Settings under Settings → Camera Settings → External Camera) and allow access for CaptureGraph; the camera connects when you return. On iOS 18.0, update iOS. |
| Red pill: couldn't connect | Another app is using the camera, a wireless connection is active, or the camera is in a bad state. | Quit other apps that use the camera, turn off its Wi-Fi and Bluetooth, turn the camera off and on, and tap Retry or reconnect. |
| Red pill: disconnected, with a banner saying the camera closed the connection | The camera ended the connection, usually because its auto power off turned it off. | Turn off the camera's auto power off, then unplug the camera and plug it back in. |
| No pill | The phone does not see the camera. | Check the cable (on Lightning, Apple's camera adapter is required). Turn off the camera's Wi-Fi, Bluetooth, and smartphone features. Choose a PTP, MTP, or card-reader mode, not a mode for the brand's own iPhone app. Unlock the phone and reconnect. Check that Import from External Cameras is on, and if Allow Access is showing under it, tap it. |
| The camera turns off, or shows a USB or charging icon, when plugged in | The camera's USB port is set to take power from the phone rather than to transfer data. The manuals name this setting USB Power Supply (Fujifilm, Sony) or USB Power Delivery (Nikon). | Set it to off; on Fujifilm, USB Power Supply/Comm Setting → Power Supply Off/Comm On. Check the USB mode in Camera Settings by Brand. |
| The pill stays grey | The camera is still reading its card. | Wait, or use a card with fewer files. |
| Green pill, but the camera will not shoot | The camera locks its shutter while connected. | Use plug to sync. |
| Green pill, but a test shot does not import | The camera does not report new shots in this mode, or wrote the shot somewhere the phone cannot see (a second card slot, or tether-only memory). | Check the USB mode and the card-slot settings, and record to the card in slot 1. Unplug the camera and plug it back in with the viewfinder open, or select the shot in the grid. |
| Warning that the camera may not report new shots | Control of the camera was declined. | Allow camera access for CaptureGraph in the iOS Settings app, then reconnect the camera. |
| Shots taken while the camera was unplugged did not import | The camera was plugged back in while no capture step was open, or CaptureGraph quit while it was unplugged. | Select them above the Last import divider. They stay on the card until imported. |
| No access to iPhone photos in the panel | Photo library access was declined. | Tap Settings and allow Photos access for CaptureGraph. |
| Only the RAW or only the JPEG ever arrives | The camera writes RAW and JPEG to different cards, and only one card is visible over USB. | Record RAW and JPEG to the same card. |
| Warning that the step does not accept the camera's preferred file | The preferred file of a RAW and JPEG pair is in a format cg.Image does not accept, so the other file was imported. |
Set the camera to a RAW format on the accepted list, such as DNG. |
| Error that the step does not accept the shot's files | No file of the shot is in an accepted format. The shot stays on the camera. | Set the camera to record a format the step accepts. |
| A movie taken during a photo step, or a photo taken during a video step, does not import | Files of the other media kind are ignored and stay on the camera. | Use a step of the matching type. |
| Uploads of camera RAW or HEIF files to a server-hosted target fail | The server runs a library from before cg.Image accepted these formats, and rejects them. |
Update the server. |
| The phone's battery drains quickly, or iOS reports that the accessory needs too much power | The camera is drawing power from the phone. | Turn off USB power supply or USB charging on the camera. On Lightning, connect a charger to the adapter. |
Storage Warnings#
Camera RAW files and movies fill a phone quickly. While you capture, CaptureGraph checks the phone's free space as files are saved: below 16 GB it shows a warning, and below 1 GB an error, because new captures may fail to save. When either appears, save the session and let its uploads finish, then free up space on the phone.
Before each import, CaptureGraph also checks that the phone has room for the file plus 256 MB. If it does not, the shot is not imported, stays on its source, and the app reports an error. Free up space, then import it again.