Many photographers keep their originals in some sort of lossless RAW format instead of compressed JPEG, especially when shooting with a Digital SLR. Some mobile phones also support RAW or use HEIC/HEIF for a similar purpose. PhotoPrism aims at providing excellent support for all RAW formats, independent of camera brand and model. Please let us know when there is an issue with your specific device.
Web browsers in general can not display RAW image files. They need to be converted, which is what our import and convert commands do. You'll also find a checkbox for this step in our Web UI.
In addition, PhotoPrism now also supports TIFF, PNG, BMP and GIF files. Be aware that files in those formats often don't contain useful metadata and are typically used for screenshots, charts, graphs and icons only.
On a Mac, PhotoPrism can convert multiple files at once using Sips (pre-installed on OS X). It is not available for other operating systems, as far as we know.
We've recently upgraded Darktable from 2.6.2 to 3.0.0. Since the old PPA is not maintained anymore, we switched to this repository that is hosted by SuSE:
Note that PhotoPrism can only run one instance of
darktable-cli because it uses a lock file. If you run it more than once, it will fail. Be prepared to wait a bit.
Using Darktable as library¶
We had the idea to use cgo and link directly against
libdarktable.so to convert RAW images to JPEG, see darktable-dev mailing list. However this requires calling/wrapping a large number of C functions and also has other disadvantages. The idea is postponed until a clear benefit becomes visible. Running
darktable-cli or any other binary that does the job (see above) seems to be the way to go.
Comparison of RAW to JPEG converters¶
- darktable - popular open-source photography app and raw developer; available for Mac, Linux, and Windows; supports XMP (compatible with photoshop/lightroom?)
- Mac OS X ships with sips:
sips -s format jpeg IMAGE.RAW --out IMAGE.JPG
- Photivo - open-source photo processor; available for Mac, Linux, and Windows; no XMP support?
- RawTherapee - open-source RAW image processing app; available for Mac, Linux, and Windows; no XMP support?
- digiKam - open-source digital photo management application based on Qt (KDE); available for Mac, Linux, and Windows; supports XMP (compatible with photoshop/lightroom?)
- UFRaw - Unidentified Flying Raw is a utility to read and manipulate raw images from digital cameras
|Tool||Command line options||Compatible OS||JPG Diff*||XMP support||Possible settings||EXIF Diff*||Compatible with Raspberry (ARM64)|
||macOS, Linux, Windows||****||yes (but seems to be not compatible with adobe xmps)||?||****||yes|
||macOS||*****||no||?||****||not available for ubuntu|
||macOS, Linux, Windows||***||no||?||****||yes|
||macOS, Linux, Windows||*||no||?||**||yes|
||macOS, Linux, Windows||*||no||?||**||yes|
|Digikam||?||macOS, Linux, Windows||-||-||-||-||-|
|Photiva||?||macOS, Linux, Windows||-||-||-||-||-|
The following table shows the difference between the JPEG files converted by Darktable, Sips, Rawtherapee, UFraw and ImageMagick compared to Adobe Photoshop. Red are pixel that differ from the photoshop version, white are equal pixels. In total 5 Images have been compared (full results). The diff was created using https://github.com/ewanmellor/git-diff-image.
|Tool||Diff (left is Photoshop)|
The following table shows the difference between the JPG files converted by the tools compared to JPG files converted by photoshop. 5 Images have been compared.
|Size||2.881.969 bytes (EXIF)/ 2.7M (ls -alh)||2.673.777 bytes / 2.5M||5.446.710 bytes / 5.2M always bigger||3.467.998 bytes / 3.3M||3.467.998 bytes / 3.3M||1.558.587 bytes / 1.5M always smaller|
|Dimension||identical - 5472 × 3648||5472 × 3648||different - 5494 × 3666||different - 5488 × 3662||different - 5496 × 3670||different - 5496 × 3670|
|Device Make||refrence||identical||identical||identical||not set||not set|
|Colour profile||Adobe RGB (1998)||different - Display P3||different - sRGB||different - RTv2_sRGB||not set||not set|
|Focal length||reference||identical||identical||identical||not set||not set|
|Alpha Channel||reference||identical||identical||identical||not set||not set|
|Red eye||reference||identical||identical||identical||not set||not set|
|Metering Mode||reference||identical||identical||identical||not set||not set|
|F number||reference||identical||identical||identical||not set||not set|
|Exposure program||reference||identical||identical||identical||not set||not set|
|Exposure time||reference||identical||identical||identical||not set||not set|
|Latitude||reference||sometimes very small differences||identical||identical||not set||not set|
|Longitude||reference||sometimes very small differences||identical||identical||not set||not set|
Adobe Photoshop / Lightroom¶
Ideally we can convert images directly with Photoshop or Lightroom, if installed. It seems like Photoshop comes with some sort of command-line automation tool based on NodeJS: https://github.com/adobe-photoshop/generator-core
This needs further investigation. Contributions welcome!
Todo / Reading List¶
- Compare the quality and XMP compatibility of different RAW converters #65
- Investigate if PhotoShop or Lightroom can be used to convert images on the command line
- Collect example RAW files of common camera brands and models
- Figure out how we can implement "auto-enhance" (automatically fix exposure and write XMP file while converting to JPEG)
- https://howtogimp.com/raw-photos-in-gimp/ - RAW converters to use with GIMP
- https://github.com/mdouchement/hdr - HDR is a library that handles RAW image format written with Golang