Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

libopenraw is Copyright (c) 2005-2023 Hubert Figuiere and
other contributors. See the respective files.
It is licensed under LGPLv3 or later. See files COPYING

mp4parse is released under MPL-2.0 license. See the MPL-2.0 file.
It is a modified version of

Code of Conduct:

Contributors to this project agree to the Code of

Prerequistes to build:

    - a C++ 11 compiler (tested on gcc 4.7 and up)
    - libboost 1.33.1 (Boost.String, Boost.Test, Boost.Variant)
    - libjpeg
    - libxml > 2.5.0 (for the test suite)
    - libcurl (option for the test suite bootstrap)
    - Rust 1.64

If building from the git tree you also need:

    - automake/autoconf
    - autoconf-archive
    - pkg-config for the associated m4 macros

Optional Gnome support

    - gdkpixbuf

## Rust crate

Starting with 0.4.0, libopenraw is developed as a Rust native crate
with a C API. There the standard layout for a Rust crate applies, and
`lib/` contains the crate part to build the dynamic library for the C

Supported file format:

Here are the supported file formats. For details per-camera, see

    - Canon CR2
    - Canon CR3
    - Canon CRW (not those coming from CHDK firmware like A610)
    - Nikon NEF and NRW
    - Olympus ORF
    - Pentax PEF
    - Epson ERF
    - DNG
    - GoPro GPR
    - Sony ARW and SR2
    - Minolta MRW
    - Panasonic RAW and RW2
    - Fujifilm RAF

How to build:

  Using automake/autoconf:

    $ ./
    $ ./configure --prefix=...
    $ make
    $ make install DESTDIR=...

Supported formats:

  T  Tested and proven to work. (I have a sample.)
  Y  Yes, it is there. (Untested as I do not have a sample but the format
     is known to be similar.) Yes, it is for the whole format.
  N  Not supported.
  B  Known to be Broken. (Needs to be fixed. I have a sample but further
     work is required.)
  X  Not needed.
  #  Sample file needed.

                         /  CFA compressed bitstream
                         | /  CFA decompress
                         | | /  Orientation Tag
                         | | | /  Bayer Type
                         | | | | /  Type ID
                         | | | | | /  Active Area (ROI)
                         | | | | | | /  Color Matrices
                         | | | | | | | /  Exif and MakerNotes
                         | | | | | | | | /  Rendering
                         | | | | | | | | | /
                         | | | | | | | | | |
Canon CR2                Y Y Y Y Y Y Y Y Y Y
Canon CR3                Y Y N Y Y Y Y Y Y N
Canon CRW                Y Y Y Y Y Y Y Y Y B

Canon CRW CHDK           N N N N N N N N N N
(unofficial firmware)

Nikon NEF                Y Y Y Y Y Y N Y Y
Nikon NRW                Y         Y N Y Y
Olympus ORF              Y Y Y Y Y Y N Y Y
Adobe DNG                Y Y B Y Y Y Y Y Y Y
GoPro GPR                Y Y N Y Y Y Y Y X N
Sony SR2                 Y Y N Y N Y N Y   B
Sony ARW                 Y Y N Y N Y N Y Y
Pentax PEF               Y Y N Y Y Y N Y Y Y
Epson ERF                Y Y Y Y Y Y N Y Y Y
Minolta MRW              Y Y Y N Y Y N Y Y Y
Panasonic RAW            Y Y N Y Y Y Y N Y B
Panasonic RW2            Y Y N Y Y Y Y N Y N
FujiFilm RAF             Y Y N Y N Y N T Y B

Sony SRF                 N N N N N N N N
Kodak DCR                N N N N N N N N
Kodak KDC                N N N N N N N N
Foveon X3F               N N N N N N N N
Mamiya MEF               N N N N N N N N
Samsung SRW              N N N N N N N N

Test suite

There is a test suite driven by an XML file. It require you to provide
your own RAW files and configure it.  testsuite/testsuite.xml is an
example of valid XML configuration file that works on my local

TODO2: provide a better description of the test file.

TODO3: fix ordiag to allow outputting a test case in XML.

Running the testsuite

$ make check

This will run it automatically.

If you need to bootstrap the testsuite, you can go as follow:

WARNING: The bootstrap will download "random" files from the
internet. They currently aren't validated.

$ make
$ cd testsuite
$ ./testsuite -b -d directory

Here directory is the existing directory where files will be
downloded.  If you build in a different directory than the source
directory, you need to set the `srcdir` environment to the path where
the testsuite binary is build.


Many online resources, including open source software were used (list
non exhaustive):

dcraw was the first open source effort out there. We all owe its
authors and contributor a lot.

Mozilla MP4 Rust parser, that is being used:
Laurent Clevy CR3 documentation, provided lot of information:

Exif & MakerNote
ExifTool is used to provide documentation and the tag table:
Exiv2 knowledge:


libopenraw: RAW file parsing and processing library (mirror and WiP)




LGPL-3.0, GPL-3.0 licenses found

Licenses found






No packages published