TetherInvert
Manual · Install
  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

Install#

The macOS app#

Download TetherInvert-<version>-macos-arm64.dmg from the releases and drag TetherInvert into Applications. It carries its own Python and libraries; nothing else is needed. Apple silicon only.

The app is not yet signed with an Apple Developer ID, so macOS refuses to open a downloaded copy the first time. Once, either open System Settings → Privacy & Security and choose Open Anyway, or run:

xattr -dr com.apple.quarantine /Applications/TetherInvert.app

Opened from the Finder, the app shows the window. Its binary also takes every command of the command line:

/Applications/TetherInvert.app/Contents/MacOS/tetherinvert status

Linux#

Download TetherInvert-<version>-linux-x86_64.tar.gz (Intel and AMD) or TetherInvert-<version>-linux-aarch64.tar.gz (64-bit ARM) from the releases, unpack it wherever it should live, and add it to your applications:

tar xzf TetherInvert-<version>-linux-x86_64.tar.gz
TetherInvert/install.sh

install.sh puts TetherInvert in the desktop's applications and tetherinvert (the command line) in ~/.local/bin, for you only. Run it again after moving the folder; TetherInvert/install.sh --remove takes both away. The folder carries its own Python and libraries. It needs a system at least as new as:

Three things are the system's to allow, not TetherInvert's:

The Lightroom plug-in is for macOS only.

From source (macOS and Linux)#

With Python 3.11 or newer:

git clone https://github.com/janpfischer/tetherinvert.git
cd tetherinvert
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
tetherinvert gui

The camera library comes with the gphoto2 package; nothing to install separately. Building the macOS or Linux app yourself is described in the project's README.