DNGLab - A camera RAW to DNG file format converter
Command line tool to convert camera RAW files to Digital Negative Format (DNG).
It is currently in alpha state, so don't expect a polished and bugfree application. Please report bugs in our issue tracker.
Examples
Convert a single file:
dnglab convert IMG_1234.CR3 IMG_1234.DNG
Convert whole directory:
dnglab convert ~/DCIM/100EOS ~/filmrolls/photos-france
Supported cameras and file formats
For a list of supported cameras please see SUPPORTED_CAMERAS.md.
Supported raw file formats
| Format | Supported | Remarks |
|---|---|---|
| CR3 | |
CR3_STATE.md |
| CR2 | |
|
| CRW | |
Supported DNG features
- DNG lossless compression (LJPEG-92)
Command line help
convert subcommand
dnglab-convert
Convert raw image(s) into dng format
USAGE:
dnglab convert [FLAGS] [OPTIONS] <INPUT> <OUTPUT>
FLAGS:
-d Sets the level of debugging information
-h, --help Prints help information
-f, --override Override existing files
-r, --recursive Process input directory recursive
-V, --version Prints version information
-v, --verbose Print more messages
OPTIONS:
--artist <artist> Set the artist tag
-c, --compression <compression> 'lossless' or 'none' [default: lossless]
--crop <crop> Apply crop to ActiveArea [default: yes]
--dng-embedded <embedded> Embed the raw file into DNG [default: yes]
--image-index <index> Select a specific image index (or 'all') if file is a image container
--ljpeg92-predictor <predictor> LJPEG-92 predictor (1-7)
--dng-preview <preview> Include a DNG preview image [default: yes]
--dng-thumbnail <thumbnail> Include a DNG thumbnail image [default: yes]
ARGS:
<INPUT> Input file or directory
<OUTPUT> Output file or existing directory
analyze subcommand
dnglab-analyze
Analyze raw image
USAGE:
dnglab analyze [FLAGS] <FILE>
FLAGS:
-d Sets the level of debugging information
-h, --help Prints help information
--json Format metadata as JSON
--meta Write metadata to STDOUT
--pixel Write uncompressed pixel data to STDOUT
--summary Write summary information for file to STDOUT
-V, --version Prints version information
-v, --verbose Print more messages
--yaml Format metadata as YAML
ARGS:
<FILE> Input file
With analyze, you can get a full dump of the internal file structure as YAML or JSON. With JSON output, it's possible to filter and transform the data with jq. For example, to get the cfa_layout from the CMP1 box for CR3 files, you can write:
find /cr3samples/ -type f -name "*.CR3" -exec dnglab analyze --meta '{}' --json \; | \
jq ". | { file: .file.fileName, cfa_layout: .format.cr3.moov.trak[1].mdia.minf.stbl.stsd.craw.cmp1.cfa_layout}"
The output is:
{
"file": "Canon EOS 90D_CRAW_ISO_250_nocrop_nodual.CR3",
"cfa_layout": 1
}
{
"file": "Canon EOS 90D_CRAW_ISO_100_nocrop_nodual.CR3",
"cfa_layout": 1
}
extract subcommand
dnglab-extract
Extract embedded original Raw from DNG
USAGE:
dnglab extract [FLAGS] <INPUT> <OUTPUT>
FLAGS:
-d Sets the level of debugging information
-h, --help Prints help information
-f, --override Override existing files
-r, --recursive Process input directory recursive
--skipchecks Skip integrity checks
-V, --version Prints version information
-v, --verbose Print more messages
ARGS:
<INPUT> Input file or directory
<OUTPUT> Output file or existing directory
FAQ
Why a DNG tool if there is already something from Adobe?
The DNG converter from Adobe is free (at cost), but not free in terms of free software. Nobody can add or fix camera support except of Adobe. And it has no support for Linux. That's why I've started writing my own little DNG swiss army knife.
Why should I use DNG instead of RAW?
Never ask. If you need DNG you will know.
Will camera/format (...) be added?
Well, depends on developer resources.
Is a GUI in planning?
Yes, DNGLab should get a GUI in near future.
Credits
Special thanks goes to:
- Darktable developer team www.darktable.org
- Laurent Clévy CR3 documentation
- Kostya Shishkov
- Hubert Kowalski
- Rawloader development team rawloader
- All volunteers who have contributed samples.
Without the support and engagement from these people the development of dnglab would not have been possible.
62 Dec 26, 2022
7 Sep 16, 2022
18 Nov 3, 2022
1 Jan 30, 2022
22 Dec 6, 2022
2 Mar 30, 2022
12 Sep 29, 2022
160 Jan 3, 2023
9 Dec 9, 2021
62 Nov 29, 2022
47 Dec 30, 2022
4 Oct 15, 2022
30 Jan 1, 2023
5 Jan 20, 2023
4 Dec 1, 2022
4 Feb 7, 2023
14 Nov 9, 2022
59 Mar 6, 2023
1 Jan 23, 2022
3 Dec 17, 2023