Skip to content

About

DarkroomPro - a precision film development calculator for B&W, C-41 and E-6: 433 film/developer combinations, sourced times, temperature/rotary compensation, batch reuse, push/pull and a darkroom timer with custom agitation.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

DarkroomPro

Platform License: CC BY-NC-SA 4.0 Built with

DarkroomPro calculates development times for black-and-white, C-41 and E-6 film from a sourced database of 47 films, 18 developers and 433 combinations. It applies per-developer temperature compensation, push/pull, agitation method and batch-reuse rules, then runs a step timer while you develop. Everything is local; no account or connection is needed.

DarkroomPro main window

Film and developer selection, process controls, results, timer and the sourced film/developer information panels.

DarkroomPro fullscreen focus display

The fullscreen focus display, toggled with F or the Auto Fullscreen option.

Features

Database — 47 films (19 black-and-white, 22 colour negative, 6 slide) and 18 developers across B&W, C-41 and E-6, giving 433 film/developer combinations. Every combination records a source, source_url and verified_date.

Temperature compensation — per-developer curves for B&W developers taken from Kodak and Ilford charts, with a standard conversion fallback where no manufacturer chart exists. Colour kits are locked to the kit's standard temperature (Tetenal 38 °C, Unicolor 38.9 °C, CineStill 39 °C); a kit's temperature table can be unlocked explicitly where it publishes one.

Push/pull — +3 stops to -2 stops. B&W falls back to the documented Massive Dev Chart guideline when a combination has no exposure-index row; colour push/pull is offered only where the kit publishes a time.

Agitation — intermittent or rotary. Rotary processing applies an adjustable 0–35% reduction to B&W development time (15% default). E-6 first-developer times switch between the published manual and rotary values; C-41 uses the kit time.

Batch reuse — enter the number of rolls already developed and the app applies only documented rules: CineStill +2% per roll, Tetenal +15 s per four rolls at 38 °C (60 s at 30 °C), Bellini +15 s per three rolls. One-shot developers show no roll-count compensation.

Timer — the developer step is timed from the calculation. Add bleach, blix, fixer, stabilizer or rinse steps with times from your kit instructions, and reorder or retime them; the step editor saves automatically. Steps can advance automatically, after a 1–60 s buffer, or manually.

Agitation reminders — cues follow each combination's published schedule, or your own initial agitation and interval (30 s at the start, 10 s every 60 s by default). A repeating tick plays during each agitation window with a distinct stop cue, and chimes can be switched off.

Darkroom mode — one toggle for the red safelight theme, wake lock and fullscreen options. The focus display opens when the timer starts (Auto Fullscreen) or with F at any time.

Export — calculation summary and process steps as JSON, CSV or PDF, saved as darkroom-calculation-<timestamp>.<format> in the Downloads folder.

Data provenance

  • Every film/developer combination carries source, source_url and verified_date.
  • B&W base times and push/pull values are researched from the Massive Dev Chart, which aggregates manufacturer-published times and curated user data. Where a combination was re-sourced, source_url points at the exact chart query used.
  • Where a manufacturer datasheet time was checked against the chart, source names both (for example Kodak F-4043 + Massive Dev Chart); the URL is the chart query.
  • Push/pull values come from the chart's published exposure-index rows for that film and dilution. When no reliable row exists the field is left empty and the app falls back to the chart's push guideline, so no values are fabricated.
  • Colour push and pull times are included only where the kit publishes them; if a value is missing the app says so instead of estimating one.
  • Batch reuse is applied only where a kit publishes a rule, stored alongside the developer. One-shot and replenished developers show no roll-count compensation.
  • The database is validated by automated tests (cargo test) that check key resolution, source coverage and time monotonicity.

Install

Download the installer for your platform from Releases:

  • macOS: DarkroomPro_<version>_universal.dmg
  • Windows: DarkroomPro_<version>_x64_en-US.msi or ..._x64-setup.exe
  • Linux: DarkroomPro_<version>_amd64.deb, DarkroomPro-<version>-1.x86_64.rpm or DarkroomPro_<version>_amd64.AppImage

On Linux, install the package with your package manager:

# Debian/Ubuntu
sudo dpkg -i DarkroomPro_<version>_amd64.deb

# RedHat/Fedora
sudo rpm -i DarkroomPro-<version>-1.x86_64.rpm

Release builds are unsigned. On macOS, right-click the app and choose Open the first time you launch it; on Windows, SmartScreen may ask you to confirm.

Quick start

  1. Select a film stock from the categorised dropdown.
  2. Choose a developer (filtered by film compatibility).
  3. Set the temperature. B&W accepts 15–30 °C with automatic compensation; colour kits stay at their standard temperature unless you opt into their published table.
  4. Adjust push/pull if needed. Unsupported colour combinations are marked "not published".
  5. Choose intermittent or rotary agitation and adjust the rotary percentage.
  6. Calculate, then start the timer.
  7. Export the calculation if you want a record.

Build from source

You need Node.js 18+, a recent stable Rust toolchain, and the platform build tools:

  • macOS: Xcode Command Line Tools
  • Windows: Microsoft C++ Build Tools
  • Linux: build-essential, libwebkit2gtk-4.1-dev, libssl-dev
git clone https://github.com/Panolix/DarkroomPro.git
cd DarkroomPro
npm install

npm run tauri:dev     # desktop app with hot reload
npm run tauri:build   # installer in src-tauri/target/release/bundle/

Vite alone (npm run dev) serves the frontend at http://localhost:1420 and is the supported web development path. npm run web:dev serves the raw source files over python -m http.server; the browser cannot resolve the bare jspdf import in rust-bridge.js that way, so use npm run dev or npm run build and serve dist/ for a browser build.

Project structure

DarkroomPro/
├── src-tauri/            # Rust backend
│   ├── src/
│   │   ├── main.rs       # Tauri entry point and commands
│   │   ├── models.rs     # Data structures
│   │   ├── calculator.rs # Calculation engine
│   │   ├── database.rs   # Database loading
│   │   └── export.rs     # JSON, CSV and PDF export
│   └── tauri.conf.json
├── dist/                 # Built web assets
├── *.js                  # Frontend JavaScript
├── *.css                 # Styling
├── *.html                # Markup
└── complete_database.json

The desktop build uses the Rust calculator. The browser build falls back to the JavaScript calculator in calculator.js when the Tauri backend is unavailable, so the desktop build is the supported one.

Contributing

Issues and pull requests are welcome. For data corrections, edit complete_database.json and include the manufacturer document or chart URL you used so the source and verified_date fields can be checked. Run cargo test and npm run test:steps before opening a pull request.

License

This project is licensed under CC BY-NC-SA 4.0.

License text: human-readable summary · full legal code · SPDX entry · LICENSE

Source-available, not open source. You may download, use, fork, modify and share it for non-commercial purposes, provided you credit Panagiotis Smponias, link back to this repository, state what you changed, and license your version under the same terms.

Commercial use requires a paid license — see COMMERCIAL.md. Attribution, share-alike and trademark terms: NOTICE.

Author

Panagiotis Smponias

Acknowledgments

  • Development data from the Massive Dev Chart, manufacturer specifications (Kodak, Ilford, Fujifilm) and community darkroom testing
  • Built with Tauri
  • UI uses the Inter font, bundled under the SIL Open Font License

About

DarkroomPro - a precision film development calculator for B&W, C-41 and E-6: 433 film/developer combinations, sourced times, temperature/rotary compensation, batch reuse, push/pull and a darkroom timer with custom agitation.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages