Desktop tool for fusing three photos of the same scene to suppress reflections -- designed for oil paintings, but useful anywhere you can move the lights between shots.
Type
Non-commercial
Non-commercial
Year
2025
Role
Developer
2025
Role
Developer
Tools
Python, ffmpeg, numpy, photography
Python, ffmpeg, numpy, photography
Goal
Remove reflections from oil paintings and produce high-quality photos without glare while preserving color.
Results
A simple GUI: start with two upload slots, add more as they fill, then click the button to get a reflection-free image saved to output/output.png.
Quick Start
1. Keep the camera fixed; take three photos while moving only the light source.
2. Launch ReflectionsRemover.exe in the project root.
3. Add at least two photos (camera fixed, move only the light); new slots appear as you fill them.
4. Press Remove reflections. The merged result lands in output/output.png, opens automatically, and the slots reset so you can run again.
2. Launch ReflectionsRemover.exe in the project root.
3. Add at least two photos (camera fixed, move only the light); new slots appear as you fill them.
4. Press Remove reflections. The merged result lands in output/output.png, opens automatically, and the slots reset so you can run again.
Build your own EXE
You need Python 3.11+ with pip available.
1) Install dependencies: python -m pip install --upgrade pip && python -m pip install numpy imageio pyinstaller.
2) Create the executable (includes ImageIO metadata and hides the console window). Output directly to the repo root (no dist/) and exclude heavy optional plugins to keep size down:
pyinstaller --noconfirm --onefile --windowed --copy-metadata imageio --exclude-module imageio_ffmpeg --exclude-module cv2 --exclude-module matplotlib --distpath . --name "ReflectionsRemover" ReflectionsRemover.py
# macOS build example (run on macOS): produces ./ReflectionsRemover
pyinstaller --noconfirm --onefile --windowed --copy-metadata imageio --exclude-module imageio_ffmpeg --exclude-module cv2 --exclude-module matplotlib --distpath . --name "ReflectionsRemover" ReflectionsRemover.py
3) The binary will be ./ReflectionsRemover.exe (Windows) or ./ReflectionsRemover (macOS) in the project root. Keep it out of git history; distribute via releases or zip separately.
4) Cross-platform note: build Windows on Windows and macOS on macOS (PyInstaller does not cross-compile between OSes).
2) Create the executable (includes ImageIO metadata and hides the console window). Output directly to the repo root (no dist/) and exclude heavy optional plugins to keep size down:
pyinstaller --noconfirm --onefile --windowed --copy-metadata imageio --exclude-module imageio_ffmpeg --exclude-module cv2 --exclude-module matplotlib --distpath . --name "ReflectionsRemover" ReflectionsRemover.py
# macOS build example (run on macOS): produces ./ReflectionsRemover
pyinstaller --noconfirm --onefile --windowed --copy-metadata imageio --exclude-module imageio_ffmpeg --exclude-module cv2 --exclude-module matplotlib --distpath . --name "ReflectionsRemover" ReflectionsRemover.py
3) The binary will be ./ReflectionsRemover.exe (Windows) or ./ReflectionsRemover (macOS) in the project root. Keep it out of git history; distribute via releases or zip separately.
4) Cross-platform note: build Windows on Windows and macOS on macOS (PyInstaller does not cross-compile between OSes).
Math
