Skip to content

IMG-135: How RAW formats are detected #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
gzigzigzeo wants to merge 2 commits into
base: master
Choose a base branch
from
+184 −0
Open

IMG-135: How RAW formats are detected #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1484eca
How RAW formats are detected
gzigzigzeo Apr 15, 2026
20e356d
Backport raw block to the latest version
gzigzigzeo Sep 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 92 additions & 0 deletions docs/image_formats_support.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,98 @@ imgproxy uses [libraw](https://www.libraw.org/) to process RAW files. For a comp
Since loading RAW images is pretty resource intensive, their processing is disabled by default. You can enable it with the [`IMGPROXY_ENABLE_RAW_FORMATS`](configuration/options.mdx#raw-formats) configuration variable.
:::

### RAW format detection ((pro)) {#raw-detect}

imgproxy detects RAW formats using the following process:

1. **Standard format detection**: First, imgproxy attempts to detect if the file is in a known non-RAW format (such as JPEG, PNG, WebP, etc.) by using magic bytes signatures.
2. **MIME type checking**: If no standard format is detected through magic bytes, imgproxy checks whether the MIME type matches any of the known RAW MIME types.
3. **Extension checking**: If the MIME type does not match, imgproxy checks if the file extension matches any of the known RAW extensions.

<details>
<summary>Supported RAW MIME types</summary>

```
image/x-hasselblad-3fr
image/x-adobe-dng
image/x-sony-arw
image/x-phaseone-cap
image/x-canon-cr2
image/x-canon-cr3
image/x-canon-crw
image/x-kodak-dcr
image/x-epson-erf
image/x-hasselblad-fff
image/x-gopro-gpr
image/x-phaseone-iiq
image/x-kodak-k25
image/x-kodak-kdc
image/x-mamiya-mef
image/x-leaf-mos
image/x-minolta-mrw
image/x-nikon-nef
image/x-nikon-nrw
image/x-olympus-orf
image/x-sony-ori
image/x-pentax-pef
image/x-apple-proraw
image/x-fuji-raf
image/x-raw
image/x-panasonic-rw2
image/x-leica-rwl
image/x-sony-sr2
image/x-sony-srf
image/x-samsung-srw
image/x-sigma-x3f
```

</details>

<details>
<summary>Supported RAW file extensions</summary>

```
.3fr
.adng
.arw
.cap
.cr2
.cr3
.crw
.data
.dcr
.dng
.eip
.erf
.fff
.gpr
.iiq
.k25
.kdc
.mef
.moc
.mos
.mdc
.mrw
.nef
.nrw
.orf
.ori
.pef
.ppm
.proraw
.raf
.raw
.rw2
.rwl
.sr2
.srf
.srw
.x3f
```

</details>

## Converting animated images to MP4 ((pro)) {#converting-animated-images-to-mp4}

Animated image results can be converted to MP4 by specifying the `mp4` extension.
Expand Down
92 changes: 92 additions & 0 deletions versioned_docs/version-4.0.x/image_formats_support.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,98 @@ imgproxy uses [libraw](https://www.libraw.org/) to process RAW files. For a comp
Since loading RAW images is pretty resource intensive, their processing is disabled by default. You can enable it with the [`IMGPROXY_ENABLE_RAW_FORMATS`](configuration/options.mdx#raw-formats) configuration variable.
:::

### RAW format detection ((pro)) {#raw-detect}

imgproxy detects RAW formats using the following process:

1. **Standard format detection**: First, imgproxy attempts to detect if the file is in a known non-RAW format (such as JPEG, PNG, WebP, etc.) by using magic bytes signatures.
2. **MIME type checking**: If no standard format is detected through magic bytes, imgproxy checks whether the MIME type matches any of the known RAW MIME types.
3. **Extension checking**: If the MIME type does not match, imgproxy checks if the file extension matches any of the known RAW extensions.

<details>
<summary>Supported RAW MIME types</summary>

```
image/x-hasselblad-3fr
image/x-adobe-dng
image/x-sony-arw
image/x-phaseone-cap
image/x-canon-cr2
image/x-canon-cr3
image/x-canon-crw
image/x-kodak-dcr
image/x-epson-erf
image/x-hasselblad-fff
image/x-gopro-gpr
image/x-phaseone-iiq
image/x-kodak-k25
image/x-kodak-kdc
image/x-mamiya-mef
image/x-leaf-mos
image/x-minolta-mrw
image/x-nikon-nef
image/x-nikon-nrw
image/x-olympus-orf
image/x-sony-ori
image/x-pentax-pef
image/x-apple-proraw
image/x-fuji-raf
image/x-raw
image/x-panasonic-rw2
image/x-leica-rwl
image/x-sony-sr2
image/x-sony-srf
image/x-samsung-srw
image/x-sigma-x3f
```

</details>

<details>
<summary>Supported RAW file extensions</summary>

```
.3fr
.adng
.arw
.cap
.cr2
.cr3
.crw
.data
.dcr
.dng
.eip
.erf
.fff
.gpr
.iiq
.k25
.kdc
.mef
.moc
.mos
.mdc
.mrw
.nef
.nrw
.orf
.ori
.pef
.ppm
.proraw
.raf
.raw
.rw2
.rwl
.sr2
.srf
.srw
.x3f
```

</details>

## Converting animated images to MP4 ((pro)) {#converting-animated-images-to-mp4}

Animated image results can be converted to MP4 by specifying the `mp4` extension.
Expand Down
Loading