TetherInvert
Manual · Command line
  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

Command line#

Everything the window does is also a command. tetherinvert --help and tetherinvert <command> --help list every option.

tetherinvert gui                        # the window
tetherinvert status                     # what is connected, and the camera's settings
tetherinvert doctor                     # a test shot and what went wrong
tetherinvert presets

tetherinvert calibrate "Portra 400" --base 0.03,0.30,0.03,0.40
tetherinvert calibrate "HP5" --base 0.03,0.30,0.03,0.40 --white --aperture f/8
tetherinvert calibrate "Gold together" --base 0.03,0.30,0.03,0.40 --together
tetherinvert --no-light calibrate "Gold own" --base 0.03,0.30,0.03,0.40 --kind own-rgb --light "RGB LED panel, each colour at 100 %"
tetherinvert light                      # the Scanlight as a manual light: r, g, b, w [level], rgb R G B, off, q

tetherinvert flatfield ~/Scans/Roll01 --preset "Portra 400"
tetherinvert scan ~/Scans/Roll01 --preset "Portra 400" --picture 0.07,0.10,0.86,0.80
tetherinvert scan ~/Scans/Roll01 --preset "Portra 400" --negative --retake
tetherinvert scan ~/Scans/Roll01 --preset "Portra 400" --compare
tetherinvert scan ~/Scans/Roll01 --preset "Portra 400" --turn 90 --mirror
tetherinvert scan ~/Scans/Roll01 --preset "Portra 400" --number 00
tetherinvert render ~/Scans/Roll01 --negative --crop --primaries prophoto --no-flatfield

tetherinvert develop ~/Scans/Roll01 3 converted
tetherinvert prints ~/Scans/Roll01 --match
tetherinvert metadata ~/Scans/Roll01 camera="Nikon FM2" film="HP5 Plus" ei=800 shot_from=2026-10-03
tetherinvert metadata ~/Scans/Roll01 --frame 7 note="Anna on the jetty" keywords_left_out=family
tetherinvert contactsheet ~/Scans/Roll01 --sprockets

tetherinvert orient ~/Scans/Roll01 7 --turn 180
tetherinvert delete ~/Scans/Roll01 7
tetherinvert delete ~/Scans/Roll01 00
tetherinvert clean ~/Scans/Roll01       # delete the RAW files
tetherinvert lightroom ~/Scans/Roll01/scans ~/Scans/Roll01/prints

Environment variables#

Variable Effect
TETHERINVERT_HOME Where presets and notes live instead of ~/.tetherinvert
TETHERINVERT_SIM=1 Same as --sim
TETHERINVERT_NO_LIGHT=1 Same as --no-light
TETHERINVERT_SIM_PICTURES With --sim, a folder of photos (JPEG, TIFF, PNG) the simulated roll shows: frame n is the nth by name, starting over past the last
TETHERINVERT_PORT The Scanlight's serial port, when the automatic choice is wrong
TETHERINVERT_LIGHTROOM_WAIT Seconds tetherinvert lightroom waits for the plug-in (default 120)