Skip to content

Releases

Scouter v0.3.0

Choose a tag to compare

@pratikgh0se pratikgh0se released this 11 Nov 12:09

First public release of Scouter: an MCP server for editing photos in darktable by conversation.

What's in it

  • Live edits in the running darktable. darkroom_say turns plain phrases ("warmer", "more contrast", "a touch brighter") into fixed parameter steps. darkroom_set sets exact values, and darkroom_undo_last takes the last change back. Each change is one darktable history item you can see and undo yourself.
  • Every write is confirmed. Scouter reads the XMP sidecar back after each edit. If darktable writes an older history over it, Scouter refuses the write and restores the sidecar.
  • Previews. scout_preview renders the current edit with darktable-cli in an isolated config, so the agent can look at the result.
  • Three layers, one core: a Python API, the scouter CLI and the scouter-mcp server, with the same verbs in each.
  • The original darktable-mcp tools (library browse, ratings, import, styles, camera ingest) still ship as the darktable-mcp command.

Install

pip install 'git+https://github.com/pratikgh0se/scouter@v0.3.0'
scouter setup

Then restart darktable, open a photo in the darkroom, and run scouter setup --check. The wheel and sdist are attached below. This fork does not publish to PyPI.

How it was tested

The release gauntlet ran on 2026-11-11 against darktable 5.4.1 on macOS, using scratch copies of real raws (Olympus and Sony):

Check Result
Cases run 6191
Crashes 0
Wrong edits (changed something not asked for) 0
Original files changed none

Known limits

  • Some "a touch" phrases make real changes that fall below the test's measurement floor on some frames.
  • "warmer" and "cooler" are refused on Sony raws whose color calibration uses a custom illuminant. Scouter will not switch that frame's illuminant mode on its own.
  • There is no per-hue color control yet (for example, "blues only").
  • Tested on macOS only.

See Honest limits in the README for the full list.

Credits

Scouter is a fork of w1ne/darktable-mcp (MIT). Both copyright lines are kept in LICENSE.