Files
SnapOtter/apps/docs/pl/guide/supported-formats.md
T
SnapOtterandGitHub d10d0f544f fix: release QA hardening across processing, media, security, and CI gates (#649)
A release-readiness QA pass over the whole product. The commits split into
defects a user would hit and gates that were reporting green while measuring
nothing.

## Fixes that change behaviour

Rate limiting was bypassable on every install: TRUST_PROXY defaulted to true, so
request.ip came from a client-set header and a forged X-Forwarded-For got past
the login limiter. The default is now a private-network trust list.

A transient Postgres outage stranded in-flight jobs, leaving finished output on
disk with no row pointing at it. A reconciler now resolves those rows and adopts
the bytes rather than dropping the work.

A Redis connection that moved to a new address wedged every read-blocked
consumer, so completions stopped signalling while health still answered 200.
Socket timeouts plus subscriber pings recover it.

Installing more than one AI bundle left the shared venv multi-versioned and
silently broke three tools. The installer now reconciles distributions to one
version each.

Converting an image to JXL at quality 1 through 4 returned a 500, because
libjxl 0.7 rejects the distance those values compute. The quality is floored at
what the encoder honours. A missing ffmpeg was also reported to the user as a
corrupt upload; it now says the engine is unavailable.

RAW uploads reached an unpatched LibRaw on arm64, so it is built from source at
0.22.2, and the release scan was split so it can fail on an unfixed critical
instead of hiding it behind ignore-unfixed.

## Gates that could not fail

Two mutation lanes ran zero mutants because Stryker crawled the gitignored docs
build; coverage discarded its whole report on any failing test; the lint gate
skipped root tests, scripts, and two workspaces; and several generated matrices
counted a host missing ffmpeg as a passing tool. Each now measures what it
claims.

Full evidence and the outstanding release items are tracked locally and are not
part of this branch.
2026-07-27 15:37:30 +08:00

11 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Obsługiwane formaty plików we wszystkich modalnościach - ponad 55 formatów wejściowych obrazów, wideo, audio, PDF oraz formaty plików. e53ecf65be25 human e9cd04f02d83

Obsługiwane formaty

SnapOtter przetwarza pliki w pięciu modalnościach: obraz, wideo, audio, PDF oraz pliki. Ta strona wymienia wszystkie obsługiwane formaty.

Formaty obrazów

SnapOtter obsługuje ponad 55 formatów obrazów na wejściu i 17 formatów na wyjściu.

Formaty wejściowe

Standardy webowe (9)

Format Rozszerzenia Dekoder Uwagi
JPEG .jpg, .jpeg Sharp (natywny)
PNG .png Sharp (natywny) Wyodrębniana pierwsza klatka APNG
WebP .webp Sharp (natywny)
GIF .gif Sharp (natywny) Obsługa animacji
AVIF .avif Sharp (natywny)
SVG .svg Sharp (librsvg) Sanityzacja pod kątem XXE/SSRF
SVGZ .svgz gunzip + Sharp Ochrona przed gzip bomb
APNG .apng Sharp (natywny) Tylko pierwsza klatka
JPEG XL .jxl djxl / ImageMagick Dwupoziomowy fallback

Profesjonalne (7)

Format Rozszerzenia Dekoder Uwagi
TIFF .tiff, .tif Sharp (natywny) Obsługa wielu stron
PSD .psd ImageMagick Spłaszczony kompozyt
EPS .eps, .epsf ImageMagick + Ghostscript Rasteryzacja 300dpi, utwardzone bezpieczeństwo
OpenEXR .exr ImageMagick Konwersja linear-to-sRGB
Radiance HDR .hdr ImageMagick Konwersja linear-to-sRGB
DPX .dpx ImageMagick Konwersja log-to-sRGB
Cineon .cin ImageMagick Format film/VFX

Camera RAW (23)

Format Rozszerzenia Marka aparatu Dekoder
DNG .dng Adobe (uniwersalny) exiftool / ImageMagick + LibRaw
CR2 .cr2 Canon (przed 2018) exiftool / ImageMagick + LibRaw
CR3 .cr3 Canon (2018+) exiftool / ImageMagick + LibRaw
NEF .nef Nikon exiftool / ImageMagick + LibRaw
NRW .nrw Nikon (Coolpix) exiftool / ImageMagick + LibRaw
ARW .arw Sony exiftool / ImageMagick + LibRaw
ORF .orf Olympus exiftool / ImageMagick + LibRaw
RW2 .rw2 Panasonic exiftool / ImageMagick + LibRaw
RAF .raf Fujifilm exiftool / ImageMagick + LibRaw
PEF .pef Pentax/Ricoh exiftool / ImageMagick + LibRaw
3FR .3fr Hasselblad exiftool / ImageMagick + LibRaw
IIQ .iiq Phase One exiftool / ImageMagick + LibRaw
SRW .srw Samsung exiftool / ImageMagick + LibRaw
X3F .x3f Sigma exiftool / ImageMagick + LibRaw
RWL .rwl Leica exiftool / ImageMagick + LibRaw
GPR .gpr GoPro exiftool / ImageMagick + LibRaw
FFF .fff Hasselblad (starsze) exiftool / ImageMagick + LibRaw
MRW .mrw Minolta exiftool / ImageMagick + LibRaw
MEF .mef Mamiya exiftool / ImageMagick + LibRaw
KDC .kdc Kodak exiftool / ImageMagick + LibRaw
DCR .dcr Kodak exiftool / ImageMagick + LibRaw
ERF .erf Epson exiftool / ImageMagick + LibRaw
PTX .ptx Pentax (kompakt) exiftool / ImageMagick + LibRaw

Nowoczesne formaty (3)

Format Rozszerzenia Dekoder Uwagi
JPEG 2000 .jp2, .j2k, .j2c, .jpc, .jpf, .jpx opj_decompress / ImageMagick Kino cyfrowe, obrazowanie medyczne
QOI .qoi Wbudowany kodek TypeScript Tworzenie gier, systemy wbudowane
HEIC/HEIF .heic, .heif heif-convert / heif-dec Zdjęcia z iPhone'a

Starsze/systemowe (4)

Format Rozszerzenia Dekoder Uwagi
BMP .bmp ImageMagick
ICO .ico ImageMagick Wyodrębniana największa warstwa
CUR .cur ImageMagick Kursor Windows (wariant ICO)
TGA .tga ImageMagick Wykrywanie tylko po rozszerzeniu

Naukowe i gamingowe (2)

Format Rozszerzenia Dekoder Uwagi
FITS .fits, .fit, .fts ImageMagick Astronomia (standard NASA)
DDS .dds ImageMagick Tekstury gier (DirectX)

Wymiany danych (6)

Format Rozszerzenia Dekoder Uwagi
PPM .ppm Sharp (natywny) Kolorowa mapa pikseli
PGM .pgm Sharp (natywny) Skala szarości
PBM .pbm Sharp (natywny) Bitmapa 1-bitowa
PNM .pnm Sharp (natywny) Format zbiorczy
PAM .pam Sharp (natywny) Dowolna mapa
PFM .pfm Sharp (natywny) Mapa zmiennoprzecinkowa

Formaty wyjściowe (17)

Format Enkoder Kontrola jakości Dostępny w
JPEG Sharp natywny 1-100 Wszystkie narzędzia
PNG Sharp natywny Kompresja 0-9 Wszystkie narzędzia
WebP Sharp natywny 1-100 Wszystkie narzędzia
AVIF Sharp natywny 1-100 Wszystkie narzędzia
TIFF Sharp natywny 1-100 Pełne narzędzia konwersji
GIF Sharp natywny 1-100 Pełne narzędzia konwersji
JXL Sharp natywny 1-100 Wszystkie narzędzia
HEIC heif-enc CLI 1-100 Pełne narzędzia konwersji
HEIF heif-enc CLI 1-100 Pełne narzędzia konwersji
BMP ImageMagick CLI Bezstratny Narzędzie konwersji
ICO ImageMagick CLI Bezstratny Narzędzie konwersji
JP2 opj_compress CLI Współczynnik kompresji Narzędzie konwersji
QOI Wbudowany kodek Bezstratny Narzędzie konwersji
PSD ImageMagick CLI Bezstratny Narzędzie konwersji
PPM ImageMagick CLI Bezstratny Narzędzie konwersji
EPS ImageMagick CLI Bezstratny Narzędzie konwersji
TGA ImageMagick CLI Bezstratny Narzędzie konwersji

Formaty wideo

Dekodowanie i kodowanie wideo obsługuje FFmpeg (kompilacja statyczna), więc każdy popularny kontener i kodek jest obsługiwany na wejściu.

Kontenery wejściowe (15)

Format Rozszerzenia Typowe kodeki Uwagi
MP4 .mp4 H.264, H.265, AV1 Najczęściej używany kontener
QuickTime .mov H.264, ProRes Nagrywanie/edycja Apple
WebM .webm VP8, VP9, AV1 Wolny od opłat format webowy
Matroska .mkv Dowolne Elastyczny otwarty kontener
AVI .avi Różne Starszy kontener Microsoftu
M4V .m4v H.264 Wariant MP4 firmy Apple
AVCHD .mts H.264 Nagrania z kamer
BDAV .m2ts H.264 Strumień transportowy Blu-ray / AVCHD
3GP .3gp H.264, MPEG-4 Nagrania mobilne
Flash Video .flv H.264, VP6 Starszy streaming
Windows Media .wmv VC-1, WMV Windows Media
MPEG .mpg, .mpeg MPEG-1, MPEG-2 Wideo z ery DVD
MPEG-TS .ts MPEG-2, H.264 Nadawczy strumień transportowy
Ogg .ogv Theora Otwarte wideo Ogg

Formaty wyjściowe

Format Rozszerzenie Kodek wideo Tworzone przez
MP4 .mp4 H.264 Konwersję, kompresję i większość narzędzi wideo
QuickTime .mov H.264 Konwersję wideo
WebM .webm VP9 Konwersję wideo
GIF .gif - Wideo do GIF
WebP .webp - Wideo do WebP (animowany)

Napisy

Format Rozszerzenie Operacje
SubRip .srt Osadzanie, wypalanie, wyodrębnianie, automatyczne generowanie
WebVTT .vtt Osadzanie, wypalanie, wyodrębnianie, automatyczne generowanie
ASS / SSA .ass Osadzanie, wypalanie (obsługa stylizacji)

Formaty audio

Audio również jest przetwarzane przez FFmpeg.

Formaty wejściowe (11)

Format Rozszerzenia Kompresja Uwagi
MP3 .mp3 Stratna Uniwersalna zgodność
WAV .wav Nieskompresowany (PCM) Studio / edycja
FLAC .flac Bezstratna Otwarty kodek bezstratny
AAC .aac Stratna Surowy strumień AAC
M4A .m4a Stratna (AAC) / Bezstratna (ALAC) Audio MPEG-4
Ogg Vorbis .ogg Stratna Otwarty format
Opus .opus Stratna Nowoczesny, niskie opóźnienie
WMA .wma Stratna Windows Media Audio
AIFF .aiff Nieskompresowany (PCM) Nieskompresowany Apple
AMR .amr Stratna Mowa / mobilne
AC-3 .ac3 Stratna Dolby Digital

Formaty wyjściowe

Format Rozszerzenie Kodek Tworzone przez
MP3 .mp3 LAME Konwersję audio, wyodrębnianie audio
WAV .wav PCM Konwersję audio, wyodrębnianie audio
FLAC .flac FLAC (bezstratny) Konwersję audio
Ogg .ogg Vorbis Konwersję audio
M4A .m4a AAC Konwersję audio, wyodrębnianie audio

Formaty dokumentów

Przetwarzanie dokumentów wykorzystuje qpdf, LibreOffice, Ghostscript, Pandoc oraz WeasyPrint.

Formaty wejściowe (15)

Format Rozszerzenia Silnik Uwagi
PDF .pdf qpdf, Ghostscript, pdfcpu Podstawowy format dokumentów
Word .docx, .doc LibreOffice Microsoft Word
Excel .xlsx, .xls LibreOffice Microsoft Excel
PowerPoint .pptx, .ppt LibreOffice Microsoft PowerPoint
OpenDocument .odt, .ods, .odp LibreOffice Tekst, arkusz, prezentacja
Rich Text .rtf LibreOffice Tekst sformatowany między aplikacjami
Plain Text .txt LibreOffice, Pandoc Tekst UTF-8
Markdown .md Pandoc CommonMark / GFM
HTML .html WeasyPrint Renderowane do PDF
EPUB .epub Pandoc, LibreOffice Format e-booków

Formaty wyjściowe

Format Rozszerzenia Tworzone przez
PDF .pdf Word/Excel/PowerPoint do PDF, Markdown do PDF, HTML do PDF
PDF/A .pdf Konwersję PDF/A (archiwizacja)
Word .docx, .odt, .rtf, .txt Konwersję dokumentu, PDF do Word, Markdown do Word
Prezentacja .pptx, .odp Konwersję prezentacji
Arkusz kalkulacyjny .xlsx, .ods, .csv Konwersję arkusza
HTML .html Markdown do HTML
EPUB .epub Konwersję do EPUB
Obrazy .png, .jpg PDF do obrazu

Formaty plików

Narzędzia do danych i archiwów konwertują między formatami strukturalnymi i pakują pliki.

Format Rozszerzenia Konwersje
CSV .csv Do/z JSON i Excela; dzielenie i scalanie; z XML
JSON .json Do/z CSV, XML i YAML
XML .xml Do/z JSON; do CSV
YAML .yaml, .yml Do/z JSON
Excel .xlsx Do/z CSV
ZIP .zip Tworzenie archiwów, wyodrębnianie zawartości