ScanStudio: Film needs to be reloaded (REFEED_REQUIRED)

[julianmkan]

ScanStudio error report
ScanStudio version: 0.3.0-beta.3
Operating system: macOS Version 15.7.3 (Build 24G419)
CPU architecture: arm64
Scanner firmware: bridge 0.1.0
Adapter: unknown
Holder: unknown
Local log: ~/.scanstudio/diagnostics/e0ac1924-ae08-4cbf-9526-12f3a183fbf1.jsonl
Diagnostic session: e0ac1924-ae08-4cbf-9526-12f3a183fbf1
Engine version: 0.1.0
Connection state: uiConnected=true; deviceKind=real; previewActive=false; scanActive=false; transport=idle
Error code: REFEED_REQUIRED

Message:
REFEED_REQUIRED: transport read was not one uniform traversal; eject or refeed the strip and run the preview again -- if this recurs on clean feeds it may be a capture or driver defect (transport anchor residual is inconsistent with one affine preview traversal (MAE 0.657 rows, max 3.005 rows))

Recent diagnostic events:

• 2026-08-07T14:51:03Z session.started
• 2026-08-07T14:51:04Z device.discovery.succeeded count=2
• 2026-08-07T14:51:08Z device.connect.requested kind=real uiConnectedBefore=false
• 2026-08-07T14:51:08Z scanner.status connected=true filmPresent=false mediaLoaded=false transport=idle
• 2026-08-07T14:51:08Z device.connect.succeeded connected=true kind=real mediaLoaded=false transport=idle
• 2026-08-07T14:51:24Z scanner.status connected=true filmPresent=true mediaLoaded=false transport=idle
• 2026-08-07T14:51:28Z preview.requested kind=initial process=c41ColorNegative uiConnected=true
• 2026-08-07T14:51:28Z preview.accepted uiConnected=true
• 2026-08-07T14:52:30Z preview.failed code=REFEED_REQUIRED uiConnectedBefore=true
• 2026-08-07T14:52:30Z scanner.status connected=true filmPresent=true mediaLoaded=false transport=idle

No images, receipts, or raw logs are attached automatically.

[rohanpandula]

thanks for the report. what that check is doing: the preview measures whether the film moved through the transport as one uniform pass, and your feed came back inconsistent by up to 3 rows. rather than guess frame geometry from a read it cant trust, it refuses and asks for a refeed.

youre not the only one hitting this family of refusal, theres a robustness round for the feed detector queued behind the current release. real reports are what tune it so a few things would help:

• which adapter and holder you fed with (SA-21? a modified full roll SA-21? FH-3?) and the film stock
• did feeding the same strip again clear it or refuse again
• the diagnostics file from that session: ~/.scanstudio/diagnostics/e0ac1924-ae08-4cbf-9526-12f3a183fbf1.jsonl (numbers and events only, no images)