TetherInvert
Manual · When something fails
  1. Overview
  2. Install
  3. The window
  4. Lights
  5. How TetherInvert thinks
  6. Your rig
  7. Calibrating a film stock
  8. Starting a session
  9. Scanning
  10. Developing
  11. Finishing the roll
  12. Contact sheet
  13. Metadata
  14. Lightroom Classic
  15. Command line
  16. When something fails

When something fails#

Start with Help › Run Doctor… in the window. It shows what is installed and connected, takes one test shot without changing any camera setting, and says whether that file decodes. The shot is kept in ~/.tetherinvert/doctor/ (Show test shot opens it).

Without the window, the same report comes from the command line:

tetherinvert doctor

Close the window first: only one program can hold the camera.

Message What to do
holds a JPEG / HEIF picture, not a RAW Set image quality to RAW only, and check that the camera's PC Remote settings do not send the JPEG to the computer.
looks like a RAW file, but the decoder cannot read it The decoder does not know this RAW type. Switch it in the camera menu, or update the decoder (pip install -U rawpy).
too small to be a RAW The download was cut short: cable or port.
Another program holds the camera Unplug and replug; quit Photos, Image Capture and sync clients. On Linux, unmount the camera in the file manager (see Install).
The camera also keeps every exposure on its memory card The camera did not take the request to save to the computer only. Set it in the camera's menu (see Your rig).
The Scanlight is not connected Plug in its data port (the left USB-C; the other is power only). The window finds it within a few seconds without touching the camera.
The camera does not answer any more The camera was lost; the window looks for it every 2 s. The Scanlight stays connected.
Lightroom Classic has not picked up the request The plug-in is not loaded, or an older one still runs after an update: restart Lightroom Classic, then check File → Plug-in Manager.
The TetherInvert fields are empty in Lightroom The photos were imported or synchronized by hand: click the roll's folder and choose Library › Plug-in Extras › TetherInvert: read metadata. See Photos you imported yourself.
Lightroom shows an old camera, lens, date or exposure Lightroom reads these only when a file is added: Metadata › Read Metadata from Files. See After you change metadata in TetherInvert.
Frames clipped (in red in the log, after a scan) See the clipping warning.
The flat field is refused Film still in the holder; or, with your own light, a light that flickers.

A shot that fails during calibration is kept in ~/.tetherinvert/failed/.

Reporting a problem#

Open an issue with what you did, what happened, the window's log (Log, then Copy), the doctor's report (Help › Run Doctor…, then Copy report, which includes the details from About TetherInvert), and your rig (camera, lens, light, operating system). For a RAW file that does not decode, attach the test shot (Show test shot) or the file from ~/.tetherinvert/failed/.