FilmeR / Film Rust

Filmr is a high-fidelity, physics-based film simulation engine written in Rust. Unlike simple LUT-based filters, Filmr simulates the physical properties of photographic film—from spectral sensitivity and grain structure to chemical development curves—to produce authentic, organic results.

• Core Features
• Quick Start
• Installation
• Supported Film Stocks
• Project Structure
• License

Filmr implements a comprehensive imaging pipeline that models the physical behavior of analog film:

• 🔬 Spectral Simulation: Accurate modeling of film spectral sensitivity (Panchromatic, Orthochromatic, Infrared) using physical wavelength data.
• 🌾 Physics-Based Grain: Spatially correlated grain synthesis based on RMS granularity and blur radius, simulating the organic texture of silver halide crystals.
• 📈 H-D Curves: Segmented characteristic curves (D-min, D-max, Gamma) for realistic tonal response and density formation.
• ✨ Halation & Bloom: Physical light scattering simulation (Gaussian diffusion) to recreate the signature "glow" of bright highlights on film.
• ⏱️ Reciprocity Failure: Simulation of film speed loss during long exposures (Schwarzschild effect).
• 🎨 30+ Film Presets: Built-in profiles for legendary stocks like Kodak Portra, Tri-X, Fujifilm Velvia, and Kodachrome.
• 📊 Diagnostic Tools: Integrated quality verification and visualization tools for analyzing color science and signal metrics.
• ⚡ High Performance: Parallelized image processing using rayon for fast rendering.

The interactive GUI allows you to drag-and-drop images and tweak simulation parameters in real-time.

cargo run -p filmr_app --bin filmr_ui --release

Visualize the color response, grain structure, and spectral characteristics of all supported films.

cargo run --example chart_diagnosis --release

Output will be saved to diagnosis_output/contact_sheet.jpg.

brew install W-Mai/cellar/filmr_app

irm https://github.com/W-Mai/filmr/releases/latest/download/filmr_app-installer.ps1 | iex

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/W-Mai/filmr/releases/latest/download/filmr_app-installer.sh | sh

• Rust Toolchain (1.70 or later)

1. Clone the repository

   git clone https://github.com/w-mai/filmr.git
   cd filmr

2. Build the project

   cargo build --release

3. Run tests

   cargo test

Filmr includes over 30 calibrated film presets, categorized by type:

This project is open source and available under the MIT License.