karimz1/imgcompress release

v1.0.0 — 2026-11-10

Changelog

Features

Image editor: Crop, pick an exact output size, add a background, text and pictures, and rotate any of them. Drag, resize and turn things right on the canvas, with snapping, a grid, undo and keyboard shortcuts. Works with touch on tablets, including iPad in landscape. On phones you get crop and size, and your design stays as it is. Guide
Fit images to an exact output size: Presets for YouTube thumbnails, Shorts and stories, Instagram, X, link previews, GitHub social previews, Pinterest, Full HD, 2K and 4K, or your own size. Crop to fill, or keep the whole image on a blurred, solid, transparent or picture background. #906
Smart crop: When cropping to a fixed size, ImgCompress keeps the important part in frame and avoids cutting through text or faces. Guide
Backgrounds: Blur, solid color, gradients with ready-made presets, or your own picture that you can move, scale, rotate, darken, blur and tint. Dots, stripes, grid lines or a checkerboard on a solid color.
Text and image layers: Up to 5 texts and 5 images per design, for titles, watermarks or a logo. Four bundled fonts, bold and italic, color, shadow, opacity and alignment. Guide
Add local AI upscaling: Small photos and drawings lose detail when enlarged with ordinary resizing. An optional upscaler now runs a local AI model on the CPU, in the web UI and CLI, up to 16K. Nothing leaves your server. #907
Conversions keep running in the background: Every conversion now runs as a job on your server. Switch apps, lock your phone, close the tab or reload the page, and your result is waiting when you come back. Finished results are kept for 48 hours after the last activity. Each job has its own secret key, so on a shared server nobody else can see your files. This also fixes "Load failed" on iPhone during long AI upscales.
Faster AI upscaling: The upscaler works on bigger pieces of the image at once, which makes it about 1.2 to 1.4 times faster on the CPU with the same quality. The progress bar now shows each file and how far the upscale is.
Image type presets for General AI upscaling: Photo (keep details) keeps skin, leaves and fine edges and is the default, Balanced smooths a little, and Old or noisy photo (smooth) works as before for grainy images. Same speed. It uses the official Real-ESRGAN weak-denoise model, built into the image.
Add SVG import: Convert SVGs to PNG, JPEG, AVIF, WebP, ICO or PDF in the web UI and CLI, with resizing and cropping. PNG keeps transparency. #938
Add WebP export: ImgCompress could already read WebP, now it can also export it, lossy or lossless. #905
Upload limit: Set MAX_UPLOAD_SIZE_MB in Docker or Compose to cap the size of each upload. It is optional, the default is 40 GB so big PSD and PDF files work. The upload area shows the limit. For a public instance we recommend 1 GB (1024). Guide
Build details in the footer: The footer shows exactly which version, RC or nightly you run. Click it for the build time, source commit and a Copy details button for bug reports. Update notices compare against the installed build. #913
Job timer: The wait screen shows how long a conversion has been running, and the result says how long it took.
Notify me when done: Set NOTIFY_URL to an Apprise URL, for example your own ntfy server, and a switch shows up while a conversion runs. Turn it on and close the tab: you get one message when it is done, with the number of images and the device, never the file names. Off by default. Guide

Bug Fixes

Cleanup and "Delete all" no longer remove files of a job that is still running. Folders of running jobs are locked across all workers, and their age counts from the last activity, so a file you are downloading is not deleted underneath you.
Downloads only serve finished conversion results. Uploaded originals and other temp files can no longer be downloaded by folder name.
Fix notify-when-done localStorage race in e2e #1028
Show toast + inline alert when notify switch fails #1029

Other Changes

Releases: A release_* tag now prepares a GitHub release draft with generated notes, RC tags publish test images without touching latest, and published notes are synced into the app's "What's new". #911 #912
Docs: Every v1.0 feature has a short guide with screenshots on the docs site.
Background jobs, faster upscaling and safer CI secrets #979
Fix CodeQL path alerts in the job store #980
Keep finished results for at least 24 hours #981
Copy buttons: work over plain http on iPhone #982
Show elapsed time while a job runs and how long it took #983
Pick up a finished job after Safari comes back, and keep it on reload #984
docs: architecture overview with diagrams #987
Optional "Notify me when done" via ntfy (Apprise) #988
Fit the wait screen on phones; clearer notification text #989
AI upscaling: image type presets for General #990
Docker: fix apt 'held broken packages' for libgomp1 on DHI #1003
Make the AI upscaling slow-CPU notice easy to see #1002
Text pass: short, direct texts across all screens #1004
Notify: open the result on any device #1007
Share link: no device cap + clearer expired message #1009
CI: steadier builds, reports and one ci-status check #1020
AI upscale: shorter hint with ntfy tip, keep-details preset as default #1023
CI: keep ci-status gate on the job graph #1025
Cancel stops the container job #1024
Docs: results kept 48 hours (release notes + architecture) #1026
Revert notify switch error UI (#1029) #1030
Restore notify switch error toast and warning #1031
prepare release/v1.0.0 #937 (Closes #905, #906, #907, #912, #913)

Security Patches

This release also includes security fixes to keep imgcompress up to date with the latest CVE reports and security alerts from Docker Hub and GitHub.

You can review the latest Docker image tags and related security information here:
https://hub.docker.com/r/karimz1/imgcompress/tags

New Contributors

@stupleb made their first contribution in #1022

Full Changelog: release_0.9.0...release_1.0.0

Setup & Updates

To install the latest version or learn how to update imgcompress, follow the official guide:

Installation & Update Guide

Pinned Version

If you need to pin your deployment to this specific release, use:

karimz1/imgcompress:1.0.0

karimz1/imgcompress release_1.0.0 v1.0.0 on GitHub