Metadata-Version: 2.4
Name: raw2film
Version: 0.6.1
Summary: RAW image editor that emulates the look of various film stocks.
Project-URL: Repository, https://github.com/JanLohse/raw2film
Project-URL: Documentation, https://janlohse.github.io/raw2film
Project-URL: Issues, https://github.com/JanLohse/raw2film/issues
Author: Jan Lohse
License-Expression: MIT
License-File: LICENSE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: imageio>=2.37.3
Requires-Dist: lensfunpy>=1.18.0
Requires-Dist: numpy>=2.4.4
Requires-Dist: opencv-python>=4.13.0.92
Requires-Dist: pillow>=12.2.0
Requires-Dist: pyexiftool>=0.5.6
Requires-Dist: rawpy>=0.26.1
Requires-Dist: scipy>=1.17.1
Requires-Dist: spectral-film-lut>=0.4.2
Description-Content-Type: text/markdown

# Raw2Film

[![PyPI version](https://img.shields.io/pypi/v/raw2film)](https://pypi.org/project/raw2film/)
[![Docs](https://img.shields.io/badge/docs-online-blue)](https://janlohse.github.io/raw2film/)
[![CI](https://github.com/JanLohse/raw2film/actions/workflows/python-app.yml/badge.svg)](https://github.com/JanLohse/raw2film/actions/workflows/python-app.yml)
[![Version](https://img.shields.io/github/v/release/JanLohse/raw2film)](https://github.com/JanLohse/raw2film/releases)
[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/JanLohse/raw2film?tab=MIT-1-ov-file#readme)
[![Python](https://img.shields.io/badge/python-3.11%20|%203.12%20|%203.13%20|%203.14-blue)](https://www.python.org/)

Raw2Film is full raw image editor with a focus on realistic film emulation.

The looks are based on published film datasheets and use the image processing pipeline
from [Spectral Film LUT](https://github.com/JanLohse/spectral_film_lut).

The film emulation includes:

- Both negative and print material emulation for a huge variety of emulsions.
- Grain with varying intensity based on brightness and hue.
- Halation to add natural glow to highlights (no data available, so intensity should be
  adjusted to taste).
- Resolution and micro-contrast matches mtf chart for each film stock.
- Set the simulated frame size to match resolution, grain intensity, and aspect ratio.

<img width="100%" alt="Raw2Film main ui" src="https://github.com/user-attachments/assets/c81315bc-1147-4f27-a590-b63fa75c3d6f" />

## Installation

To run Raw2Film it is required to have installed [exiftool](https://exiftool.org/) on
your system.
On Linux this can be done easily with

```bash
sudo apt install exiftool
```

### Windows
Download the latest `.exe` from the [releases](../../releases) page and run it.

Alternatively, install via Python (see [below](#python-package)).

### Linux
Download the `.AppImage` from the [releases](../../releases) page and make it executable:

```bash
chmod +x spectral_film_lut-{version}.AppImage
./spectral_film_lut.AppImage
```

Alternatively, install via Python (see [below](#python-package)).

### macOS
There is currently no native binary available for macOS.
Install and run the application using a Python-based method.
See the [Python Package](#python-package) section below.

### Python Package

Install the application using your preferred Python package manager. We show it for the
default pip. Others can be found in the full documentation.

```bash
pip install git+https://github.com/JanLohse/spectral_film_lut
```

Then just run with:

```bash
spectral_film_lut
```

## Usage

The interface is designed to be familiar for anyone who has used a raw editor before.

- The image bar on the bottom lets you select one or multiple images to edit at once. (
  Select multiple with Shift or Ctrl.)
- Copy settings from one image to the selected ones by clicking on the thumbnail with
  the middle mouse button.
- Double click on a settings label to reset to the default value.
- Many shortcuts are available. Hover over a setting to see its description and
  shortcut.
- By default a simplified render is activated for preview to make the software more
  responsive. Activate the full preview under view to see the full film characterisitcs.

### Filmstock Selector

When clicking on the magnifying glass a window opens to search and browse through the
available film stocks.

<img width="100%" alt="Film stock selection ui" src="https://github.com/user-attachments/assets/5af71ab0-3802-4d22-b9e7-6f9e09efc7c4" />
