You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+19Lines changed: 19 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -166,5 +166,24 @@ The above will download all build dependencies (including a Python installation)
166
166
and is fully configured through the four environment variables.
167
167
Set `USE_CONDA = '0'` to build within an existing Python environment.
168
168
169
+
## FAQ
170
+
171
+
### I'm getting "LibRawFileUnsupportedError: Unsupported file format or not RAW file"
172
+
173
+
This error occurs when rawpy/LibRaw cannot recognize the file as a supported RAW image format. Common causes include:
174
+
175
+
1.**The file is not actually a RAW file** - Make sure you're trying to open a RAW image file (e.g., .NEF, .CR2, .ARW, .DNG, etc.) and not a regular image format like JPEG or PNG.
176
+
177
+
2.**The file is corrupted or incomplete** - If the file was not fully downloaded or is damaged, LibRaw cannot read it properly.
178
+
179
+
3.**The file lacks proper headers** - Some proprietary or headerless RAW formats are not supported by LibRaw. RAW files need to contain proper metadata headers that identify the camera model, sensor configuration, and other essential information for LibRaw to decode them.
180
+
181
+
4.**Unsupported camera or RAW format** - While LibRaw supports a [wide range of cameras](https://www.libraw.org/supported-cameras), some very new or obscure camera models may not be supported yet. Check the LibRaw website for the list of supported cameras.
182
+
183
+
**What you can do:**
184
+
- Verify the file is a genuine RAW file from a supported camera
185
+
- Try opening the file with the camera manufacturer's software to confirm it's valid
186
+
- Check if you're using the latest version of rawpy, as newer versions may support additional cameras
187
+
- If you have a headerless or proprietary RAW format, you may need to convert it to a standard format like DNG using the camera manufacturer's tools first
0 commit comments