Skip to content

Spektrafilm (dev branch) analog film simulation module - #21534

Draft
piratenpanda wants to merge 73 commits into
darktable-org:masterfrom
piratenpanda:spektrafilm
Draft

Spektrafilm (dev branch) analog film simulation module#21534
piratenpanda wants to merge 73 commits into
darktable-org:masterfrom
piratenpanda:spektrafilm

Conversation

@piratenpanda

@piratenpanda piratenpanda commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

This module brings the spektrafilm project (https://github.com/andreavolpato/spektrafilm) to darktable. Spektrafilm simulates analog film processes and applies them to digital images.

This module has been derived from the spektrafilm project and tries to stay as close or exact to the algorithms used there.

Currently it looks like this:
grafik

Film and print stocks can easily be selected via drop downs. Further settings are then handled inside the respective tabs (currently untranslated).

Default settings are Portra 400 and Portra Endura which transform your image from
grafik

to
grafik

Currently almost every film/paper combination from the spektrafilm dev branch is working except for Kodak 2302. Grain, Halation and Diffusion models are working as well.

Discussion thread and the python script needed to create the necessary spektrafilm data for darktable can be found here: https://discuss.pixls.us/t/spektrafilm-darktable-module-sort-of/58744/

Current dtdocs PR darktable-org/dtdocs#993

@piratenpanda
piratenpanda marked this pull request as draft July 12, 2026 07:57
Comment thread src/common/spektra_core.c
Arecsu added a commit to Arecsu/spektrafilm that referenced this pull request Jul 14, 2026
Uses spektrafilm's dev branch (git+https://github.com/andreavolpato/spektrafilm@dev)
to generate pack.json, spectra_lut.f32, and profiles/*.json for the native
darktable module (PR darktable-org/darktable#21534).

Run: uv run --python 3.13 --with 'spektrafilm@git+https://github.com/andreavolpato/spektrafilm@dev' python3 export_pack.py -o ~/.config/darktable/spektrafilm
@Arecsu

Arecsu commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

This is just amazing, love this

Comment thread src/iop/spektrafilm.c Outdated
Comment thread src/iop/spektrafilm.c Outdated
@Arecsu

Arecsu commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Right now there is a problem where, if I load up an already existant photo + XMP settings from my database, the module won't show up and I will get this in the CLI:

   312.1009 cannot get iop-order for spektrafilm instance 0
   467.4585 cannot get iop-order for spektrafilm instance 0
   467.4784 cannot get iop-order for spektrafilm instance 0

I have to edit a new image from a clean slate in order for the spektrafilm module to show up.

Other than that, working awesome. This is the scariest, closest film simulation look and feel I've ever got from any photo editing pipeline, in any software. And oh god did I spent a crazy amount of time on it. Main reason I fell in love with Darktable was because I could get really close to it with the existent modules. AGX, Diffuse and Sharpen, LUTs... Until I came across spektrafilm, and now this module... it is a game changer. There's currently no way to achieve these visuals otherwise. Props to @andreavolpato!

@piratenpanda

Copy link
Copy Markdown
Contributor Author

@Arecsu should be fixed with the latest commit

@Arecsu

Arecsu commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

@piratenpanda Thank you!

You may be interested in Arecsu@f2ce151, which I made on top of your PR

I've created this pre-compression boost as I find myself reaching out the tone curve module very often to push the histogram to the right when I use spektrafilm, because it tends to aggressively limit the highlights ceiling in some cases. This slider should preserve the characteristics of the module, gently pushing or pulling the histogram.

Feel free to test it and incorporate it into your PR in any case!

@Arecsu

Arecsu commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Hey, I found another reference: this Davinci Resolve OFX based on spektrafilm and exposing far more options, in a nice workflow as well:

I think the UI/UX and the options exposed by it are more appealing here in darktable for this module, as well as the logic behind them.

Here at 5:45 you can see it being used. It does seem comprehensible and with many interesting sliders and selectors as well.

@piratenpanda

Copy link
Copy Markdown
Contributor Author

Thanks for the input. I'd like to move design/implementation discussions to the pixls thread to make it easier to follow :)

@TurboGit

Copy link
Copy Markdown
Member

@piratenpanda : I would edit the first message to give a high level description of what this does, what is the goal and maybe some screenshots with before/after to illustrate the points.

@piratenpanda

Copy link
Copy Markdown
Contributor Author

@TurboGit initial update done. Thanks!

@piratenpanda piratenpanda changed the title Initial darktable spektrafilm (dev branch) module adds a spektrafilm (dev branch) analog film simulation module Jul 15, 2026
@piratenpanda piratenpanda changed the title adds a spektrafilm (dev branch) analog film simulation module Spektrafilm (dev branch) analog film simulation module Jul 15, 2026
Arecsu added a commit to Arecsu/spektrafilm that referenced this pull request Jul 18, 2026
The C port of spektrafilm (PR darktable-org/darktable#21534) needs a
data pack — pack.json, spectra_lut.f32, and profiles/*.json — at
~/.config/darktable/spektrafilm/. This script extracts the data from
the Python package using colour-science and numpy.
Arecsu added a commit to Arecsu/spektrafilm that referenced this pull request Jul 18, 2026
Uses spektrafilm's dev branch (git+https://github.com/andreavolpato/spektrafilm@dev)
to generate pack.json, spectra_lut.f32, and profiles/*.json for the native
darktable module (PR darktable-org/darktable#21534).

Run: uv run --python 3.13 --with 'spektrafilm@git+https://github.com/andreavolpato/spektrafilm@dev' python3 export_pack.py -o ~/.config/darktable/spektrafilm
@TurboGit TurboGit added priority: low core features work as expected, only secondary/optional features don't feature: new new features to add documentation: pending a documentation work is required release notes: pending labels Jul 24, 2026
@TurboGit TurboGit added this to the 5.8 milestone Jul 24, 2026

@TurboGit TurboGit left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another pass... some more questions.

Comment thread src/iop/spektrafilm.c
Comment thread src/iop/spektrafilm.c Outdated
Comment thread src/iop/spektrafilm.c Outdated
Comment thread src/iop/spektrafilm.c Outdated
Comment thread src/iop/spektrafilm.c Outdated
Comment thread src/iop/spektrafilm.c
Comment thread src/iop/spektrafilm.c Outdated
Comment thread src/iop/spektrafilm.c Outdated
@anoderay

anoderay commented Aug 4, 2026

Copy link
Copy Markdown
Collaborator

Regarding the discussion about including the spektrafilm data pack: IMHO, we don't currently have any other module that depends on an active internet connection to work out of the box. Especially for opening older edits offline. (Yes, the AI features require a download, but they don't affect existing edits.)
A possible compromise: bundle the latest data pack by default, and fall back to the newly implemented download functionality only when an older edit references a data pack version that isn't bundled.

Given how actively spektrafilm is being developed, I also think it would make sense to include a version switcher for the filmic-style presets as already discussed.

@da-phil

da-phil commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Nice module, thank you for taking on the task to bring spektrafilm to darktable!
After having had another look at the original python implementation, I wonder if we also want to establish a couple of (unit)tests (in src/tests) to ensure functionality doesn't silently break when changes are made to the code.

@piratenpanda

Copy link
Copy Markdown
Contributor Author

Nice module, thank you for taking on the task to bring spektrafilm to darktable! After having had another look at the original python implementation, I wonder if we also want to establish a couple of (unit)tests (in src/tests) to ensure functionality doesn't silently break when changes are made to the code.

I ported the unit tests. Currently no pack data is in this PR but as darktable will ship the most recent one the tests are already in place currently looking at /data/spektrafilm. Will update once we know which version will be shipped with darktable or at all.

piratenpanda and others added 29 commits August 15, 2026 09:43
…d missing glare stage and scanner feature set
…n film and print for the respective part, reset to default value
… proper bauhaus widget, add blank lines between routined, use GList where necessary, use dt_hash(), add underscore prefex to static routines
The new module was missing from the `all` modules group listing.
The reference's multiplicative USM (_finalize_grain in grain.py) runs on the
absolute density -- the grain sampler's floor is still present and only
removed afterwards (add_micro_structure -> blur -> USM -> -= density_min).
The delta-model combine already took the floor back out, so pass it back in
as an offset -- added to both operands before the D/blur(D) ratio and
subtracted from the result, on both CPU and GPU: without the floor the ratio
is ill-conditioned in the deepest shadows and the USM amplifies shadow noise
the reference never does.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation: pending a documentation work is required feature: new new features to add priority: low core features work as expected, only secondary/optional features don't release notes: pending

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants