Kader

Crops camera scans of film negatives to the analog film frame. Every result is sorted green, yellow or red, and you check and fix it in a local web UI. darktable, RawTherapee and Lightroom can be connected, but none of them is needed.

Schneidet abfotografierte Filmnegative auf den analogen Filmrahmen zu. Jedes Ergebnis wird grün, gelb oder rot einsortiert, und du prüfst und korrigierst es in einer lokalen Web-Oberfläche. darktable, RawTherapee und Lightroom lassen sich anbinden, nötig ist keins davon.

No Python, no terminal. Double-click, pick the folder of scans, check the crops in the browser. Windows 10 and 11; Linux from Ubuntu 22.04, Mint 21 or Debian 12. Uses darktable? The first start offers to set up the plugin.

Kein Python, kein Terminal. Doppelklicken, den Ordner mit den Scans wählen, die Zuschnitte im Browser prüfen. Windows 10 und 11; Linux ab Ubuntu 22.04, Mint 21 oder Debian 12. Du nutzt darktable? Der erste Start bietet an, das Plugin einzurichten.

On a NAS or over SSH: with Python, kader FOLDER --tui shows the status in the terminal (see Terminal). All versions on the release page.

Auf einem NAS oder per SSH: mit Python zeigt kader ORDNER --tui den Stand im Terminal (siehe Terminal). Alle Versionen auf der Release-Seite.

A demo film scan with the detected frame marked, and the cropped frame next to it
Demo data: The screenshots and the before/after picture show drawn demo rolls. Only the darktable panel is still a placeholder graphic.Demodaten: Die Bildschirmfotos und das Vorher-nachher-Bild zeigen gezeichnete Demo-Rollen. Nur das darktable-Panel ist noch eine Platzhalter-Grafik.
5Film formatsFilmformate
3Labels: green, yellow, redLabels: grün, gelb, rot
6Output targetsAusgabe-Ziele
209Hand-cropped reference photosVon Hand zugeschnittene Referenzfotos
DetectionErkennung

Finds the film frame

Findet den Filmrahmen

When you digitize negatives with a camera, the film strip and table stay in the picture. Kader detects the frame and suggests a crop. RAW files are developed first, JPEG, TIFF and PNG are read directly.

Beim Abfotografieren von Negativen bleiben Filmstreifen und Tisch im Bild. Kader erkennt den Rahmen und schlägt einen Zuschnitt vor. RAW-Dateien werden vorher entwickelt, JPEG, TIFF und PNG direkt gelesen.

RollRolle

Scale from the perforation

Maßstab aus der Perforation

Each subfolder is one roll. The hole spacing of 35 mm film gives the exact scale of the roll, so the crop size is known and each image only has to find its position.

Jeder Unterordner ist eine Rolle. Der Lochabstand von 35-mm-Film liefert den genauen Maßstab der Rolle, die Crop-Größe steht also fest, und jedes Bild muss nur noch seine Position finden.

ReviewPrüfen

Web UI for the check

Web-Oberfläche zur Kontrolle

Tiles sorted green, yellow and red, a crop editor with drag handles and alternative candidates, and re-detection of a selection with other settings. Accept with A, skip with S.

Kacheln nach Grün, Gelb und Rot, ein Crop-Editor mit Ziehgriffen und alternativen Kandidaten und Neu-Erkennung einer Auswahl mit anderen Einstellungen. Akzeptieren mit A, überspringen mit S.

TargetsZiele

Output where you work

Ausgabe dorthin, wo du arbeitest

Cropped copies, a crop list as JSON and CSV, darktable sidecars, RawTherapee profiles, Lightroom XMP sidecars or straight into darktable with the plugin. The web UI suggests one and explains all of them.

Zugeschnittene Kopien, eine Crop-Liste als JSON und CSV, darktable-Sidecars, RawTherapee-Profile, Lightroom-XMP-Sidecars oder mit dem Plugin direkt in darktable. Die Web-Oberfläche schlägt eins vor und erklärt alle.

TiltSchräglage

Straightens tilted frames

Stellt schiefe Rahmen gerade

The detection also measures how far a frame is tilted, up to about ±9°. One key (T) straightens the image in the editor, one button a whole selection.

Die Erkennung misst auch, wie schief ein Rahmen liegt, bis etwa ±9°. Eine Taste (T) stellt das Bild im Editor gerade, ein Knopf eine ganze Auswahl.

OriginalsOriginale

Non-destructive

Nicht destruktiv

The scans are never changed. Sidecars are added to, not replaced. Go back to the review, change something and press Finish again: only what changed is written.

Die Scans werden nie verändert. Sidecars werden ergänzt, nicht ersetzt. Zurück zur Prüfung, etwas ändern und erneut Fertig: Geschrieben wird nur, was sich geändert hat.

ReviewKontrolle

Check the yellow ones, skip the rest

Prüfe die gelben, spare dir den Rest

After the detection the web UI opens in your browser. Green crops can usually stay. Yellow ones deserve a look. Red images are not cropped unless you fix or accept them, so nothing is guessed.

Nach der Erkennung öffnet sich die Web-Oberfläche im Browser. Grüne Zuschnitte können meist bleiben. Gelbe verdienen einen Blick. Rote Bilder werden nicht zugeschnitten, außer du korrigierst oder akzeptierst sie, es wird also nichts geraten.

  • Each image shows which factors make up its confidence
  • Change the green and yellow thresholds in the web UI if too much lands in one color
  • Size to whole roll and Re-detect selection fix whole groups at once
  • The label goes along to the target: as a color label in darktable, RawTherapee and Lightroom, as a label column in the crop list
  • Jedes Bild zeigt, aus welchen Faktoren sich seine Konfidenz zusammensetzt
  • Ändere die Grün- und Gelb-Schwelle in der Web-Oberfläche, wenn zu viel in einer Farbe landet
  • Größe auf Rolle und Auswahl neu erkennen korrigieren ganze Gruppen auf einmal
  • Das Label geht mit ans Ziel: als Farblabel in darktable, RawTherapee und Lightroom, als Spalte label in der Crop-Liste
a grid of thumbnails with green, yellow and red labelsa grid of thumbnails with green, yellow and red labels
results sorted by labelErgebnisse nach Label sortiert
DetectionErkennung

See what the detection found

Sieh, was die Erkennung gefunden hat

Four strategies run side by side: contours, Canny and Hough lines, brightness gradients and a brightness mask for under-exposed images. Where they agree, the confidence goes up. For a single image, the detection can write a debug image with every candidate it considered.

Vier Strategien laufen nebeneinander: Konturen, Canny- und Hough-Linien, Helligkeitsverläufe und eine Helligkeitsmaske für unterbelichtete Bilder. Wo sie übereinstimmen, steigt die Konfidenz. Für ein einzelnes Bild kann die Erkennung ein Debug-Bild mit allen betrachteten Kandidaten schreiben.

  • Run python3 kader.py --debug -o out.jpg scan.jpg for one image
  • The JSON output holds x, y, width, height, the confidence and the review flag
  • In the web UI the crop editor offers the other candidates to pick from
  • Führe python3 kader.py --debug -o out.jpg scan.jpg für ein einzelnes Bild aus
  • Die JSON-Ausgabe enthält x, y, width, height, die Konfidenz und das Kontroll-Flag
  • In der Web-Oberfläche bietet der Crop-Editor die anderen Kandidaten zur Auswahl an
four detection strategies drawn on the same film scanfour detection strategies drawn on the same film scan
detection candidates on a scanErkennungs-Kandidaten auf einem Scan
darktable · RawTherapee

Works with your RAW developer

Arbeitet mit deinem RAW-Entwickler

Kader does not replace darktable or RawTherapee. It sets the crop, the straightening and a color label where they pick it up, and leaves the rest of your edit alone. None of it needs a terminal.

Kader ersetzt weder darktable noch RawTherapee. Es setzt Zuschnitt, Geradestellen und ein Farblabel dort, wo sie es übernehmen, und lässt den Rest deiner Bearbeitung in Ruhe. Nichts davon braucht ein Terminal.

  • darktable plugin: the first start of the app offers to set it up. In darktable, select images, click Review starten, check in the browser, press Finish, then Plan anwenden. Good for images already in darktable.
  • darktable sidecars: without the plugin, Kader adds the crop as history steps to the .xmp next to each image. After Finish, darktable öffnen imports the folder. Good for new rolls.
  • RawTherapee: Kader writes the crop into the .pp3 profiles; RawTherapee öffnen shows the folder. RawTherapee has no plugin interface, so Kader always runs first.
  • Existing edits stay: darktable history and .pp3 settings are added to, blue and purple labels are kept
  • darktable-Plugin: Der erste Start der App bietet an, es einzurichten. In darktable Bilder auswählen, Review starten, im Browser prüfen, Fertig, dann Plan anwenden. Gut für Bilder, die schon in darktable liegen.
  • darktable-Sidecars: Ohne Plugin hängt Kader den Zuschnitt als Verlaufsschritte an die .xmp neben jedem Bild. Nach Fertig importiert darktable öffnen den Ordner. Gut für neue Rollen.
  • RawTherapee: Kader schreibt den Zuschnitt in die .pp3-Profile; RawTherapee öffnen zeigt den Ordner. RawTherapee hat keine Plugin-Schnittstelle, Kader läuft also immer vorher.
  • Vorhandene Bearbeitungen bleiben: darktable-Verlauf und .pp3-Einstellungen werden ergänzt, blaue und lila Labels bleiben
Placeholder graphic: the Kader panel in darktable
Placeholder: the panel in darktablePlatzhalter: das Panel in darktable

How it works

So funktioniert es

The detection and the web UI do not depend on any photo tool. Only the two ends are swappable: a RAW converter on the way in (only for RAW files) and a target on the way out.

Erkennung und Web-Oberfläche hängen von keinem Fotoprogramm ab. Nur die beiden Enden sind austauschbar: ein RAW-Konverter auf dem Weg hinein (nur für RAW-Dateien) und ein Ziel auf dem Weg hinaus.

FolderOrdnerScans, one subfolder per roll, or a darktable selectionScans, ein Unterordner je Rolle, oder eine darktable-Auswahl
RAW converterRAW-Konverterdarktable-cli, rawtherapee-cli oroder rawpy
DetectionErkennungOpenCV and NumPy: crop and confidence per image, consensus per rollOpenCV und NumPy: Crop und Konfidenz je Bild, Konsens je Rolle
Web UIWeb-OberflächeLocal server: check, fix, finishLokaler Server: prüfen, korrigieren, fertig
TargetZielCopies, crop list, darktable, .pp3 or Lightroom XMPKopien, Crop-Liste, darktable, .pp3 oder Lightroom-XMP

Usage

Nutzung

  1. Double-click the Windows or Linux package and pick the folder of scans. With Python: kader ~/Scans/2026-09.
  2. Wait for the detection; a small window shows the progress as a film strip. Then the web UI opens in your browser.
  3. At the top, pick the target: what Finish writes. One is already suggested.
  4. Check the yellow and red images, fix crops in the editor, straighten tilted frames.
  5. Press Finish. The result is written at once and shown per image at the top. The small window offers the next step: open the output folder, darktable or RawTherapee.
  6. Not happy? Back to review, change it and press Finish again.
  1. Doppelklicke das Paket für Windows oder Linux und wähle den Ordner mit den Scans. Mit Python: kader ~/Scans/2026-09.
  2. Warte auf die Erkennung; ein kleines Fenster zeigt den Fortschritt als Filmstreifen. Dann öffnet sich die Web-Oberfläche im Browser.
  3. Wähle oben das Ziel: was Fertig schreibt. Eins ist schon vorgeschlagen.
  4. Prüfe die gelben und roten Bilder, korrigiere Zuschnitte im Editor, stelle schiefe Rahmen gerade.
  5. Drücke Fertig. Das Ergebnis wird sofort geschrieben und oben je Bild angezeigt. Das kleine Fenster bietet den nächsten Schritt an: Ausgabeordner, darktable oder RawTherapee öffnen.
  6. Nicht zufrieden? Zurück zur Prüfung, ändern und erneut Fertig.
OptionOptionMeaningBedeutung
--targetTarget, see below (default: suggested from the folder)Ziel, siehe unten (Standard: aus dem Ordner vorgeschlagen)
--converterdarktable, rawtherapee, rawpy
--films 33 34Only these rolls (subfolders)Nur diese Rollen (Unterordner)
--newAnalyse again instead of continuingNeu analysieren statt fortsetzen
--tuiStatus display in the terminal, for a NAS or SSHStatusanzeige im Terminal, für NAS oder SSH
--bind 0.0.0.0Reachable from the network (read the security note in the README first)Im Netzwerk erreichbar (vorher den Sicherheitshinweis im README lesen)

kader check FOLDER lists the available converters and the suggested target.

kader check ORDNER zeigt die verfügbaren Konverter und das vorgeschlagene Ziel.

In the terminal: NAS and SSH

Im Terminal: NAS und SSH

Where there is no desktop, kader FOLDER --tui replaces the small window with a live status display in the terminal: session, target, the green, yellow and red counts, a progress bar during RAW export and detection, the result after Finish, and the address of the web UI in large type in the middle. Open that address in a browser on any other device.

Wo es keinen Desktop gibt, ersetzt kader ORDNER --tui das kleine Fenster durch eine laufende Statusanzeige im Terminal: Sitzung, Ziel, die Zahl der grünen, gelben und roten Bilder, ein Fortschrittsbalken bei RAW-Export und Erkennung, das Ergebnis nach Fertig und die Adresse der Web-Oberfläche groß in der Mitte. Diese Adresse öffnest du im Browser eines beliebigen anderen Geräts.

Targets

Ziele

TargetZielWritesSchreibtStraightensStellt gerade
copiesCropped copies per roll, plus the crop listZugeschnittene Kopien je Rolle, dazu die Crop-Listeyesja
jsoncrops.json and crops.csv: crop in pixels and normalised, angle, labelcrops.json und crops.csv: Crop in Pixeln und normiert, Winkel, Labelangle in the fileWinkel in der Datei
xmpAdobe sidecar for Lightroom and Camera Raw: crop and color label (RAWs only)Adobe-Sidecar für Lightroom und Camera Raw: Crop und Farblabel (nur RAWs)nonein
rawtherapee.pp3 profile: crop and color label.pp3-Profil: Crop und Farblabelnonein
darktable_xmpdarktable sidecar .xmp: crop and rotation as history steps, color label; darktable reads it on importdarktable-Sidecar .xmp: Zuschnitt und Drehung als Verlaufsschritte, Farblabel; darktable liest sie beim Importyesja
darktableThrough the Lua plugin, as a history stepÜber das Lua-Plugin, als Verlaufsschrittyesja

The darktable_xmp output is checked against darktable 5.6. For images already imported into darktable, turn on look for updated XMP files on startup or use the plugin. The xmp and rawtherapee targets are not yet tested against Lightroom and RawTherapee themselves. Capture One is not supported. The limits of each target are listed in the web UI and in the README.

Die Ausgabe von darktable_xmp ist gegen darktable 5.6 geprüft. Für Bilder, die schon in darktable importiert sind, beim Start nach aktualisierten XMP-Dateien suchen einschalten oder das Plugin nehmen. Die Ziele xmp und rawtherapee sind noch nicht gegen Lightroom und RawTherapee selbst getestet. Capture One wird nicht unterstützt. Die Grenzen jedes Ziels stehen in der Web-Oberfläche und im README.

Confidence and labels

Konfidenz und Labels

ConfidenceKonfidenzLabelLabelWhat happensWas passiert
0.5 and upab 0,5GreenGrünCroppedZugeschnitten
0.3 up to 0.50,3 bis 0,5YellowGelbCropped, marked for reviewZugeschnitten, zur Kontrolle markiert
Below 0.3Unter 0,3RedRotNot cropped unless you fix or accept itNicht zugeschnitten, außer du korrigierst oder akzeptierst es

The confidence combines size agreement with the roll, edge score, exposure and how reliable the roll's scale is. Rolls without a confirmed scale get half the confidence, because their size can be off for the whole roll without any sign of it. The thresholds are defaults and can be changed in the web UI.

Die Konfidenz verbindet Größenübereinstimmung mit der Rolle, Kanten-Score, Belichtung und wie verlässlich der Maßstab der Rolle ist. Rollen ohne bestätigten Maßstab bekommen die halbe Konfidenz, weil ihre Größe für die ganze Rolle danebenliegen kann, ohne dass es sich zeigt. Die Schwellen sind Standardwerte und lassen sich in der Web-Oberfläche ändern.

ScanningScannen

Frame the negative so the detection can measure it

Negative so scannen, dass die Erkennung sie messen kann

The hole spacing of 35 mm film (4.7625 mm) is a physical constant. Kader uses it to work out the exact scale of a roll — but only if the perforation is actually in the scan.

Der Lochabstand von 35-mm-Film (4,7625 mm) ist eine physikalische Konstante. Kader nutzt sie, um den genauen Maßstab einer Rolle zu bestimmen — aber nur, wenn die Perforation überhaupt mit im Scan ist.

  • Leave a visible margin with the holes on at least one edge, ideally both
  • Don't crop tight to the image content when scanning — 6 of the rolls tested so far had no perforation at all, and dropped from ~93% to ~41% hit rate
  • Frame the negative so it fills roughly 80–95% of the file, not edge-to-edge and not with a lot of empty space around it
  • Lass an mindestens einer Kante, besser beiden, einen sichtbaren Rand mit den Löchern stehen
  • Scanne nicht randscharf bis an den Bildinhalt — 6 der bisher getesteten Rollen hatten gar keine Perforation im Scan und fielen von ~93 % auf ~41 % Trefferquote
  • Der Rahmen soll etwa 80–95 % der Datei füllen, weder randscharf noch mit viel Leerraum drumherum

Full guide: scan-howto.en.md · auf Deutsch: scan-howto.md

Ausführliche Anleitung: scan-howto.md · in English: scan-howto.en.md

Placeholder graphic: three example scans, too tight, correctly framed and too loose
Too tight, good, too looseZu eng, gut, zu weit
RollRolle

Scan a whole roll the same way

Eine Rolle durchgängig gleich scannen

The pitch measurement sums the autocorrelation over every image of a roll, because the film sits in the same place in each scan. Keep the scanner setting and the framing the same across the roll, and scan more than a couple of images — from about twelve on, Kader can cross-check the measurement against itself.

Die Takt-Messung summiert die Autokorrelation über alle Bilder einer Rolle, weil der Film in jedem Scan an derselben Stelle liegt. Halte Scanner-Einstellung und Bildausschnitt über die ganze Rolle gleich und scanne mehr als nur ein paar Bilder — ab etwa zwölf kann Kader die Messung gegen sich selbst prüfen.

  • Don't change the scanner preset partway through a roll
  • Keep the film holder clean; its own pattern can be mistaken for perforation
  • Single, standalone negatives work too, but capture both edges and scan sharp — there is no second half to cross-check against
  • Wechsle das Scanner-Preset nicht mitten in einer Rolle
  • Halte den Filmhalter sauber; sein eigenes Muster kann mit der Perforation verwechselt werden
  • Auch einzelne, lose Negative funktionieren — dann aber beide Ränder erfassen und scharf scannen, denn es gibt keine zweite Hälfte zum Gegenprüfen
Placeholder graphic: a consistently scanned roll compared to a roll with mixed framing
Consistent roll vs. mixed framingDurchgängige Rolle gegen wechselnden Ausschnitt

Detected film formats

Erkannte Filmformate

FormatFormatAspect ratioSeitenverhältnis
35 mm 135 (default)Kleinbild 135 (Standard)2:3
Medium format 6×6Mittelformat 6×61:1
Medium format 6×4.5Mittelformat 6×4,54:5
Medium format 6×7Mittelformat 6×76:7
Medium format 6×9Mittelformat 6×92:3

Where it stands

Wo es steht

The workflow is complete: folder in, web UI, six targets, darktable optional, packages for Windows and Linux. The detection hits about 87 % of the frames on 62 test rolls (about 84 % on undeveloped RAW negatives). The main error is a constant size offset per roll, not scatter inside a roll, so a whole roll can be slightly off together.

Der Ablauf ist vollständig: Ordner hinein, Web-Oberfläche, sechs Ziele, darktable optional, Pakete für Windows und Linux. Die Erkennung trifft auf 62 Testrollen etwa 87 % der Rahmen (etwa 84 % auf nicht entwickelten RAW-Negativen). Der Hauptfehler ist ein konstanter Größenversatz je Rolle, keine Streuung innerhalb der Rolle, eine ganze Rolle kann also gemeinsam leicht danebenliegen.

The confidence has become more honest: about 96 % of the green results are right, and rolls whose scale could not be confirmed are marked down instead of looking sure. For rolls without perforation in the scan this is not solved, only shown.

Die Konfidenz ist ehrlicher geworden: Etwa 96 % der grünen Ergebnisse stimmen, und Rollen, deren Maßstab sich nicht bestätigen ließ, werden abgewertet, statt sicher zu wirken. Für Rollen ohne Perforation im Scan ist das nicht gelöst, nur ausgewiesen.

NextAls NächstesGoalZiel
Real imagesEchte BilderBefore and after examples and screenshots of the web UI on this pageVorher-nachher-Beispiele und Bildschirmfotos der Web-Oberfläche auf dieser Seite
darktable on Windowsdarktable unter WindowsCheck the plugin in a real darktable on Windows (so far only tested on Linux)Das Plugin in echtem darktable unter Windows prüfen (bisher nur unter Linux getestet)
Test the sidecarsSidecars prüfenCheck the xmp and rawtherapee output in Lightroom and RawTherapee themselvesDie Ausgabe von xmp und rawtherapee in Lightroom und RawTherapee selbst prüfen
Learn from feedbackAus Rückmeldungen lernenUse the corrections made in the web UI to find where the detection failsDie Korrekturen aus der Web-Oberfläche nutzen, um zu finden, wo die Erkennung scheitert

Details in the roadmap and the changelog.

Details in der Roadmap und im Changelog.

Calibration

Kalibrierung

The reference data comes from the same web UI with the reviews target. A reference test shows how many detected crops lie within tolerance of your hand crops, and tiles are marked hit or miss. Corrections and accepted crops are saved as ground truth.

Die Referenzdaten kommen aus derselben Web-Oberfläche mit dem Ziel reviews. Ein Referenz-Test zeigt, wie viele erkannte Crops innerhalb der Toleranz zu deinen Handcrops liegen, und Kacheln tragen die Marke Treffer oder Abweichung. Korrekturen und bestätigte Crops werden als Ground Truth gespeichert.

Installation

Installation

Download (Windows, Linux)

Herunterladen (Windows, Linux)

No Python and no terminal. Double-click, pick the folder, and the review opens in the browser while a small window shows the progress. RAWs are developed without other programs.

Kein Python und kein Terminal. Doppelklicken, den Ordner wählen, und die Prüfung öffnet sich im Browser, während ein kleines Fenster den Fortschritt zeigt. RAWs werden ohne weitere Programme entwickelt.

darktable plugin

darktable-Plugin

If darktable is installed, the first start of the app offers to set up the plugin. Close darktable first. The app copies the plugin, turns it on in the Script Manager and remembers where the app lives; if you move the app, the next start updates that. The panel in the lighttable is called Kader. Later: Kader darktable-plugin install, uninstall or status.

Ist darktable installiert, bietet der erste Start der App an, das Plugin einzurichten. darktable vorher schließen. Die App kopiert das Plugin, schaltet es im Script Manager ein und merkt sich, wo die App liegt; verschiebst du sie, trägt der nächste Start das nach. Das Modul im Leuchttisch heißt Kader. Später: Kader darktable-plugin install, uninstall oder status.

With Python

Mit Python

git clone https://github.com/shrippen/kader.git cd kader ./install.sh --standalone # command "kader", without darktable ./install.sh # darktable plugin (Linux)

--standalone sets up its own environment in ~/.local/share/kader/venv with OpenCV, NumPy, Pillow and rawpy and links kader to ~/.local/bin. By hand: pip install ".[raw]". Without --standalone it installs the darktable plugin for Python; then enable contrib → Kader in the Script Manager. Only this way offers the old direct mode Detect & Queue.

--standalone richtet eine eigene Umgebung unter ~/.local/share/kader/venv mit OpenCV, NumPy, Pillow und rawpy ein und verlinkt kader nach ~/.local/bin. Von Hand: pip install ".[raw]". Ohne --standalone wird das darktable-Plugin für Python installiert; danach im Script Manager contrib → Kader einschalten. Nur dieser Weg bietet den alten Direktmodus Detect & Queue.

Questions

Fragen

Do I need darktable?Brauche ich darktable?

No. Kader runs on its own with a web UI and writes cropped copies, a crop list or sidecars. darktable is one of six targets.

Nein. Kader läuft eigenständig mit einer Web-Oberfläche und schreibt zugeschnittene Kopien, eine Crop-Liste oder Sidecars. darktable ist eines von sechs Zielen.

Plugin or sidecars in darktable?Plugin oder Sidecars in darktable?

darktable reads a sidecar only when it imports an image. For a new roll that is not in darktable yet, the sidecars are the simplest: Finish, then darktable öffnen. For images you already imported, use the plugin; it applies the crop inside darktable.

darktable liest eine Sidecar nur beim Import eines Bildes. Für eine neue Rolle, die noch nicht in darktable ist, sind die Sidecars am einfachsten: Fertig, dann darktable öffnen. Für schon importierte Bilder nimm das Plugin; es setzt den Zuschnitt in darktable selbst.

Windows warns about the file. Is it safe?Windows warnt vor der Datei. Ist sie sicher?

The warning appears because the exe is not signed; a signature costs money every year. The file is built by GitHub from the public source code, see the release workflow in the repository. Click More info → Run anyway.

Die Warnung erscheint, weil die exe nicht signiert ist; eine Signatur kostet jedes Jahr Geld. Die Datei baut GitHub aus dem öffentlichen Quelltext, siehe den Release-Workflow im Repository. Klicke Weitere Informationen → Trotzdem ausführen.

Can I trust a green label?Kann ich einem grünen Label trauen?

Mostly, but not blindly. About 96 % of the green results on the test rolls were right. Look at a sample of the green images too, especially on rolls where the perforation is missing from the scan.

Meistens, aber nicht blind. Etwa 96 % der grünen Ergebnisse auf den Testrollen waren richtig. Sieh dir auch von den grünen Bildern eine Stichprobe an, besonders bei Rollen, auf deren Scans die Perforation fehlt.

Why are red images not cropped?Warum werden rote Bilder nicht zugeschnitten?

A wrong crop costs more than no crop. Below the yellow threshold Kader leaves the image alone and only labels it, unless you fix or accept it in the web UI.

Ein falscher Zuschnitt kostet mehr als kein Zuschnitt. Unter der Gelb-Schwelle lässt Kader das Bild in Ruhe und markiert es nur, außer du korrigierst oder akzeptierst es in der Web-Oberfläche.

Does it change my original files?Ändert es meine Originaldateien?

No. Copies go into a separate folder, sidecars only get the crop, rotation and color label added, and in darktable the crop is a normal history step you can undo.

Nein. Kopien landen in einem eigenen Ordner, Sidecars bekommen nur Zuschnitt, Drehung und Farblabel ergänzt, und in darktable ist der Zuschnitt ein normaler Verlaufsschritt, den du zurücknehmen kannst.

Why one roll per folder?Warum eine Rolle je Ordner?

Kader assumes a folder is one roll, shot with the same camera and distance, so the frame size is almost constant. It fixes the size once per roll and only solves the position per image.

Kader nimmt an, dass ein Ordner eine Rolle ist, mit gleicher Kamera und gleichem Abstand fotografiert, sodass die Rahmengröße fast konstant ist. Es legt die Größe einmal je Rolle fest und löst pro Bild nur die Position.

Can I run it on a NAS?Kann ich es auf einem NAS laufen lassen?

Yes. --tui shows the status in the terminal over SSH, and --bind makes the web UI reachable from another computer. Read the security note in the README before opening it to the network.

Ja. --tui zeigt den Stand per SSH im Terminal, und --bind macht die Web-Oberfläche von einem anderen Rechner aus erreichbar. Lies vor dem Öffnen ins Netzwerk den Sicherheitshinweis im README.

Why the name?Warum der Name?

In German film jargon, a “Kader” is a single frame on the film strip, exactly what the tool looks for.

„Kader“ ist Filmjargon für ein Einzelbild auf dem Filmstreifen, genau das, was das Werkzeug sucht.