DarkBridge

Bridge Nikon sidecars to Darktable, seamlessly.

DarkBridge is a utility that converts Nikon NX Studio .nksc sidecar files into sidecar files compatible with Darktable. It helps photographers migrate adjustment data from Nikon’s workflow to Darktable without manually recreating edits. Furthermore, DarkBridge displays the sidecar content in a ‘human-readable’ way, and allows to search a metadata or image adjustment by name in a file tree structure.

NX Studio (and the previous software as View-NX2, ViewNX-i, Capture NX-D) may save image adjustments to “sidecar” files in an NKSC_PARAM folder within the same folder as the original image. In this case, any changes to pictures will be saved in image adjustment (sidecar) files (extension .nksc) separate from the original image data. Because changes are not applied directly to the original image data, pictures can be edited repeatedly with no loss in quality. Sidecar files are also used to store labels, ratings, XMP/IPTC metadata, and other data in addition to image adjustments.

Warning

Image adjustments may be saved in the original image file, this script do not support this mode. If an image file has not a sidecar file, DarkBridge will ignore it. Same for orphan sidecar files.

For this project, the image samples have been shot with a Nikon D70s camera and a Nikon D7100 camera using NEF format (Lossless Compressed RAW (14-bit), Adobe RGB). NX Studio v1.10.1 has been used to develop and edit the samples images.

DarkBridge is written in Python and delivered a Python package named DarkBridge including a command line interface darkbridge. This is the documentation for DarkBridge 0.1.0a1.

Table Of Contents

Users Guide is designed for a end-user audience and details use cases. It mainly documents the script (darkbridge.main_cli) delivered with the python package in charge of the user interface (in text mode) and operations scheduling.

Developer Guide are designed for a developer audience for contributing to the project. This documentation describes scripts, modules, exceptions, classes, functions and data composing the project. Each script or module includes a section named “Using…” explaining how to use the script or module with some examples.

Background Papers are designed for a developer audience by providing technical background papers regarding the architecture, data structure and similar topics.

Users Guide

• main_cli – Command line interface

Developer Guide

• darkbridge – Convert Nikon sidecar files
• sidecar – Handle sidecar files
• library – Supporting modules

Background Papers

• Inside Nikon Sidecar file
• Inside Nikon GPS Information
• Inside Nikon image adjustments
• Inside nik::AdaptivePaste
• Inside nik::Crop
• Inside nik::GaussianBlur
• Inside nik::GrainNoise
• Inside nik::LCH
• Inside nik::LevelsCurves
• Inside nik::Newton
• Inside nik::Rotate
• Inside nik::Straighten
• Inside nikon::ActiveDLighting
• Inside nikon::ApplicationData
• Inside nikon::Brightness
• Inside nikon::ChrAb
• Inside nikon::ColorBalance
• Inside nikon::ColorBooster
• Inside nikon::ColorShift
• Inside nikon::Dehaze
• Inside nikon::Diffraction
• Inside nikon::Distortion
• Inside nikon::DLightingHQ
• Inside nikon::DLightingHS
• Inside nikon::DustOff
• Inside nikon::ExposureSettings
• Inside Nikon::FishEye
• Inside nikon::Flare
• Inside nikon::LEGeneral
• Inside nikon::LongChrAb
• Inside nikon::NoiseReduction
• Inside nikon::NXHistory
• Inside nikon::Perspective
• Inside nikon::PhotoEffects
• Inside nikon::PictureControl
• Inside nikon::PixelShiftNoiseReduction
• Inside nikon::QuickFixContrast
• Inside nikon::QuickFixToneCurve
• Inside nikon::RedEye
• Inside nikon::SizeRes
• Inside nikon::SkinSoftening
• Inside nikon::SkinTone
• Inside nikon::transform
• Inside nikon::UnsharpMask
• Inside nikon::Vignette
• Inside nikon::WhiteBalance

Indices and tables

• Module Index
• Index
• Glossary

Work to be done

Todo

Reduire le spectre des filtres (lié aux traitement d’image)

(The original entry is located in /home/docs/checkouts/readthedocs.org/user_builds/darkbridge/checkouts/develop/src/darkbridge/sidecar/nikon.py:docstring of darkbridge.sidecar.nikon.NikonSideCar.is_adjusted, line 6.)