Hi @gnulab-id! I'm Dosu and I’m helping the Stirling-PDF team.

The reason you always get a zip file when converting PDF to PNG—even for a single PNG—is that Stirling-PDF is designed to zip the output whenever an operation produces multiple files, and this logic is also applied to PDF-to-image conversions. The "Zip files when the number of files" setting only affects batch operations (like compressing multiple PDFs at once), not single operations that generate multiple files (such as one PNG per PDF page) or even just one file in some cases. This behavior is intentional and currently not overridden by any other setting or configuration option [discussion].

Recent updates have introduced an "auto-unzip" feature for API responses and downloads, which can automatically extract files from ZIPs if enabled, but this does not change the fact that the server still sends a ZIP file for PDF-to-PNG conversions. There is no built-in way to force a direct PNG download instead of a ZIP when only one image is produced [PR 4584].

If you want to avoid the ZIP, you would need to manually extract the PNG from the ZIP file after download.

To reply, just mention @dosu.

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}