
A RawTherapee .badpixels file uses native RAW pixel coordinates and a filename matching the camera make and model. A coordinate taken from the displayed image can be offset from that native grid. If the correction lands in the wrong place, check coordinate convention before adding more points.
RawPedia's Bad Pixels section documents both the naming requirement and the RAW border offsets. This is a small calibration text file, not a painted retouch mask.
Establish that the point belongs in a persistent map
A map applies to matching camera images. Do not add a scene feature merely because it appears bright in one frame.
Use an identifiable repeatable defect and retain the source evidence. The hot-pixel diagnosis guide explains why stars, reflections and sensor defects should not be treated as the same thing.
For a proposed setup check, begin with one verified location. A long list assembled from uncertain screen coordinates is difficult to diagnose when only some entries appear to work.
Use the camera identity RawTherapee actually reports
Open a relevant RAW and inspect Quick info for the make/model text. Use the expected camera identity for the make model.badpixels filename, not a shortened folder label or a marketing nickname.
Place the file in the directory configured under Preferences > Image Processing > Dark-Frame. The correct file in an unrelated profile directory is not the same setup.
Keep the text file's real extension visible in the operating system. A filename ending in .badpixels.txt would not be the intended artifact simply because the file manager hides its last extension.
Convert coordinates only once
RawPedia documents a border offset of four pixels for Bayer sensors and seven for X-Trans. It describes adding the appropriate offset to coordinates read from RawTherapee, or declaring that offset on the file's first line.
Choose one convention and follow it consistently. Do not adjust every coordinate and then declare the same offset again.
Record whether a location came from the native RAW grid or the application's displayed coordinate system. A cropped or resized export is not a reliable source of native sensor coordinates. The RAW development guide helps explain why a rendered image is a different representation.
Validate the single-point map before expanding it
Open a retained test source from the matching camera and inspect the intended location at a useful scale. Check the corrected result as well as neighboring valid detail.
If the file is not being found, the manual describes temporarily enabling verbose output to inspect the expected name. Use that diagnostic only if needed, retain the original configuration and restore the setting afterward.
A successful single-point check does not prove every candidate defect belongs in the map. Add only locations with a defensible coordinate source and repeatable reason for correction. No sensor test or software execution is claimed here.
Related tasks
- Are the Bright Colored Dots in My Night Photo Stars or Hot Pixels?
- Should I Develop a RAW Photo Before Using AI Image Editing?
Sources and scope
- RawPedia: Dark-Frame: Dark frames address fixed-pattern/thermal effects. Automatic selection uses camera, ISO and shutter metadata. Bad-pixel maps require native coordinates and specific naming.
Official RawPedia documentation was opened on October 23, 2026 (Asia/Shanghai). Examples, commands and acceptance procedures are proposed and have not been executed for this guide. Software behavior and paths should be checked against the installed build.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance with proposed examples, not a claim of hands-on testing or an independent product review. Report a correction.
Cover: Mariya Eskina / Pexels, Pexels License. This is an illustrative source photograph, not an application screenshot or a generated test result.