rawkit

Package Status Docs Status Build Status Test Coverage Status MIT License

Note

rawkit is still alpha quality software. Until it hits 1.0, it may undergo substantial changes, including breaking API changes.

rawkit is a ctypes-based set of LibRaw bindings for Python inspired by Wand. It is licensed under the MIT License.

from rawkit.raw import Raw
from rawkit.options import WhiteBalance

with Raw(filename='some/raw/image.CR2') as raw:
  raw.options.white_balance = WhiteBalance(camera=False, auto=True)
  raw.save(filename='some/destination/image.ppm')

Requirements

  • Python
    • CPython 2.7+
    • CPython 3.4+
    • PyPy 2.5+
    • PyPy3 2.4+
  • LibRaw
    • LibRaw 0.16.x (API version 10)
    • LibRaw 0.17.x (API version 11)

Installing rawkit

First, you’ll need to install LibRaw:

Now you can fetch rawkit from PyPi:

$ pip install rawkit

Getting Help

Need help? Join the #photoshell channel on Freenode. As always, don’t ask to ask (just ask) and if no one is around: be patient, if you part before we can answer there’s not much we can do. Stick around if you can; we’d love it if you’d pay it forward and help someone else in turn.

Tutorials

Architecture and Design

API Reference

The rawkit package provides two modules: rawkit and libraw. The rawkit module provides a high-level Pythonic interface for developing raw photos, while the libraw module provides a CTypes based interface for interacting with the low-level LibRaw C APIs. Most of the time, developers will want to use the rawkit module instead of using libraw directly.

Indices and tables