FAQ & TROUBLESHOOTING • 21 QUESTIONS
Frequently Asked Questions
Answers regarding installation gatekeeper, RAW compatibility, scanning pitfalls, printer lights, and data privacy.
Q01. Why does Windows SmartScreen or macOS Gatekeeper show a security warning upon first launch?
NexFilm Engine is an open-source, non-profit photography tool. We currently do not pay hundreds of dollars annually for commercial enterprise code-signing certificates. Windows SmartScreen and macOS Gatekeeper will display security notices for unsigned binaries. Follow our step-by-step authorization guide to launch safely: First Launch Security Clearance →
Q02. How do I bypass the macOS "App is damaged / Developer cannot be verified" quarantine prompt via Terminal?
macOS automatically places downloaded open-source binaries under quarantine. Open your Terminal and run the following command to lift it immediately:
Alternatively, authorize it via System Settings > Privacy & Security. See macOS Authorization Guide →
xattr -cr /Applications/NexFilm\ Engine.appAlternatively, authorize it via System Settings > Privacy & Security. See macOS Authorization Guide →
Q03. Is there an official Linux build available? How can I compile from source?
Our CI builds packages for macOS and Windows. Linux users can compile from source using Rust Cargo, requiring
webkit2gtk-4.1 and libraw. Simply run cargo build --release in the repository root to produce a native executable. See Platform Selection →Q04. Will updating to a new version overwrite my film roll edits and history database?
Never. NexFilm separates the application binary from your user data. All film indices, edits, and crop geometries are safely stored in your system SQLite database (
nexfilm_user.db), ensuring smooth, lossless upgrades. See Data Storage and Backup Protocols →Q05. Why does digitizing with a mirrorless RAW produce vastly superior results compared to flatbed scanner JPEGs?
JPEGs are compressed 8-bit files baked with scanner-native gamma curves and lossy algorithms, discarding exposure headroom and original emulsion transmittance. Camera RAW files preserve un-interpolated, linear photon sensor counts, permitting accurate optical density calculations () with complete color fidelity. See Format Support Matrix →
Q06. Why cannot Nikon Z8 / Z9 high-efficiency (HE / HE*) RAW files be imported?
NexFilm utilizes the open-source LibRaw decoder, which does not yet license Nikon's proprietary TicoRAW compression. Please record your camera RAW files in "Lossless Compression RAW" format or convert them with Adobe DNG Converter prior to import. See RAW Format Specifications →
Q07. What light source requirements are needed for camera scanning backlight?
Your backlight panel is critical. We strongly recommend a dedicated light panel with high color rendering (CRI ≥ 95 / TLCI ≥ 98). Budget LED panels often display severe spectral gaps in the cyan/amber boundary, resulting in stubborn color crossovers. See Optical Illumination Best Practices →
Q08. Will importing massive Hasselblad Imacon / Flextight .fff files crash or exhaust RAM?
No. As of v1.1.0, NexFilm natively decodes .fff files as scanner transmission data with a streaming bounded proxy architecture, preventing memory spikes. See Bounded Proxy Architecture →
Q09. Why does my image appear dull, dark, and lacking contrast after Auto Invert?
The film active area (Film Area) includes exposed light table edges or sprocket holes. Backlight provides 100% transmittance, far brighter than any emulsion. If included in the bounding box, the algorithm misinterprets it as the image highlight, severely underexposing the frame. Simply shrink the crop box to exclude bare light borders. See Troubleshooting Decision Tree →
Q10. How should I process 120 medium format rolls without leader black frames?
120 rolls lack the black leader found in 135 cassettes. You do not need leader calibration—simply click "Auto Invert". NexFilm's bounded span compensation automatically computes optimal tone endpoints based on actual emulsion distribution. See 120 and Headless Roll Fallback →
Q11. When shooting mixed scenes on a roll, should I invert per frame or batch calibrate?
If digitized under identical light and camera settings, use Roll Calibration Batch Inversion. Sample film base once and run Auto Invert Roll. All frames share the roll's global highlight reference. For frames under mixed lighting, simply adjust Printer Lights individually. See Whole Roll Batch Processing →
Q12. Will edge light flare or blue borders corrupt color calculation?
Yes. Edge flaring usually stems from film holder reflections or lens vignetting. Adjust the corner handles in "Film Area" inward to encompass only clean, unvignetted emulsion. See Framing Pitfalls and Optical Mechanisms →
Q13. How do Printer Lights differ fundamentally from standard Temperature / Tint sliders?
Printer Lights recreate physical additive color timing from traditional optical darkroom enlargers. Red (R), Green (G), and Blue (B) sliders operate in logarithmic density units along complementary color axes. The adjustment respects photochemical emulsion response curves rather than digital hue warping. See Printer Lights Logarithmic Laws →
Q14. How can I inspect the sharpening mask in real time using the Alt / Option key?
In the Develop > Detail panel, hold the Alt key (Option on macOS) while dragging Amount, Radius, or Detail sliders. The canvas instantly switches to a high-contrast monochrome sharpening mask via shaders, showing exactly which edges are emphasized while preserving smooth emulsion grain. See Tone Curves and Detail Panel →
Q15. What is the recommended workflow order for the four Tone Curve channels (Master, R, G, B)?
The classic darkroom rule: Global balance first, local contrast second. Step 1: Neutralize global color casts with Printer Lights; Step 2: Shape tonal contrast and highlight rolloff on Master Curve; Step 3: Polish subtle shadow/highlight tints via individual R, G, B point curves. See Four-Channel Spline Curves →
Q16. What tips are recommended for Black & White (B&W) film inversion?
Toggle B&W mode on the right panel to activate the monochrome optical pipeline. Pairing this mode with our 7 built-in Ilford MGFB paper grade LUTs provides authentic variable contrast darkroom prints. See Pure Silver Halide Monochrome Workflow →
Q17. What export format and bit-depth are recommended for master archival?
For continued grading in Lightroom, Photoshop, or DaVinci Resolve, export as 16-bit TIFF or Linear DNG. 16-bit preserves 65,536 tonal levels per channel, preventing posterization during extreme color adjustments. For web sharing, export high-quality sRGB JPEG. See Six Export Formats Decision Matrix →
Q18. What is the specific use case for "Linear Export"?
Enabling Linear Export bypasses all tone and gamma curves, outputting raw physical optical transmittance density data with embedded linear ICC. This provides colorists and researchers with an untainted scientific master suitable for ACES pipelines. See Linear Export and Master Delivery →
Q19. Does batch export peg all CPU/GPU cores? How is UI responsiveness maintained?
NexFilm's Rust multi-threaded export engine dynamically balances thread priority according to system load. Even during a 36-frame 50MP batch export, the main UI and grading canvas remain smooth at 60 FPS. See Full-Roll Background Export Queue →
Q20. Does NexFilm upload scans or telemetry to remote cloud servers?
Zero uploads, zero telemetry, zero network dependencies. NexFilm is 100% offline. All functions operate fully without an internet connection, ensuring your artistic assets remain strictly on your local disk. See Known Limitations and Disclosures →
Q21. Where are project databases stored? How can I create a full backup?
All project indices, grades, and crops reside in a local SQLite file. Back up your raw scan folders alongside the application database:
Windows: %APPDATA%\NexFilm Engine\nexfilm_user.db
macOS: ~/Library/Application Support/NexFilm Engine/nexfilm_user.db
See Cross-Platform Data Storage and Backup →
Windows: %APPDATA%\NexFilm Engine\nexfilm_user.db
macOS: ~/Library/Application Support/NexFilm Engine/nexfilm_user.db
See Cross-Platform Data Storage and Backup →
Have Unanswered Questions?
Join our GitHub Discussions or open an Issue to collaborate with the creator and community photographers.