Repolode
Submit
karimz1

karimz1/imgcompress

Self-hosted Docker web toolbox for converting 70+ image formats, bulk compression, per-file cropping, and local AI background removal.

Open-source alternative to:TinyPNGAdobe Photoshop Express

View on GitHubWebsite
Stars
346
Forks
34
Open issues
34
Last commit
3 days ago

What is it?

ImgCompress is a self-hosted image processing server packaged as a single Docker container. It handles format conversion, compression, cropping, PDF generation and AI background removal from one browser interface, with a CLI available for scripting.

It accepts over 70 input formats, including HEIC, PSD, AVIF, EPS, PDF, TIFF and WebP, and can output common image formats or a paginated PDF. Each uploaded file can be cropped separately using ratio presets or pixel dimensions before conversion. The background removal model runs on the local CPU, so files are processed on the host and not sent to external services.

The project targets homelab users and anyone who wants to avoid uploading personal or client photos to online converters. It ships with Docker Compose configurations for LAN use and for deployment behind a Traefik reverse proxy with HTTPS. The UI is available in 12 languages and the project is licensed under GPL-3.0.

Key features

  • 01Converts 70+ input formats such as HEIC, PSD, AVIF, EPS and PDF
  • 02Removes backgrounds with a bundled AI model running locally
  • 03Bulk compression using multi-core parallel processing
  • 04Per-file cropping with ratio presets or custom pixel sizes
  • 05Exports images or paginated PDFs from a web UI or CLI
  • 06Runs fully offline after the image is pulled

Use cases

  • Converting iPhone HEIC photos to WebP or JPG on a home server
  • Turning PSD or screenshots into PDFs for sharing
  • Batch-compressing a large photo library without cloud uploads
  • Removing backgrounds from client photos without third-party services

Quick start

  1. 1

    Run the container with Docker

    docker run -d \ --name imgcompress \ -p 3001:5000 \ karimz1/imgcompress:latest
  2. 2

    Open the web UI in your browser

Things to know

  • Requires Docker to run.
  • Licensed under GPL-3.0, which requires derivative works to remain open source.

Topics

#image-processing#image-compression#self-hosted#docker#background-removal#heic#pdf#webp#ai#datahoarder

FAQ

What is imgcompress?
Self-hosted Docker web toolbox for converting 70+ image formats, bulk compression, per-file cropping, and local AI background removal. ImgCompress is a self-hosted image processing server packaged as a single Docker container. It handles format conversion, compression, cropping, PDF generation and AI background removal from one browser interface, with a CLI available for scripting.
Is imgcompress free to use? What license does it have?
imgcompress is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is imgcompress still maintained?
Actively maintained. The last commit to imgcompress was on Oct 17, 2026.
What can I use imgcompress for?
Converting iPhone HEIC photos to WebP or JPG on a home server Turning PSD or screenshots into PDFs for sharing Batch-compressing a large photo library without cloud uploads Removing backgrounds from client photos without third-party services
How do I install imgcompress?
Run the container with Docker: docker run -d \ --name imgcompress \ -p 3001:5000 \ karimz1/imgcompress:latest Open the web UI in your browser
Where can I get imgcompress?
The source code and installation instructions are on GitHub: https://github.com/karimz1/imgcompress

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects