Resize images without squishing what matters. Squishless changes a photo's width, height or aspect ratio with seam carving: people, buildings and faces keep their shape, while empty sky, water and plain backgrounds absorb the change.
It runs on your own computer as a small local web app. You start one program, it opens in your browser, and your images never leave your machine.
- Fast. About 0.1-0.3 s for a typical 1000 × 650 photo.
- Batch. Drop in many images, resize them all, download one by one or as a ZIP.
- Any size or shape. Exact pixels, percent, fit width or fit height, plus presets for common social and web formats. Shrink or enlarge.
- Before/after slider to check every result, plus side-by-side and fullscreen views.
- Keep or remove things. Paint areas to protect (green) or to remove first (red).
- Face protection and tunable carving (blur radius, edge threshold).
Prebuilt programs for Windows, macOS and Linux are on the
Releases page. Unzip, run
squishless (squishless.exe on Windows), and the app opens at http://127.0.0.1:7878.
The builds are not code-signed, so Windows SmartScreen or macOS Gatekeeper may warn on first launch. See Troubleshooting.
You need Go (the latest release is best; 1.22 is the minimum). Nothing else: no Node, no C compiler.
git clone https://github.com/HaiderAli3D/Squishless.git
cd Squishless
go run ./cmd/squishless # opens http://127.0.0.1:7878Or build a standalone program:
go build -o squishless.exe ./cmd/squishless # drop .exe on macOS / LinuxGetting started has the full setup, cross-compiling and the command-line options.
- Drop one or more images on the page (or click choose files, or paste with Ctrl+V).
- Pick a size: Exact (for example 1080 × 1080), Percent, Fit width or Fit height, or click a preset.
- Press Resize all (Ctrl+Enter).
- Drag the divider in Before and after to compare, then Download one image or Download all (.zip).
To remove an object or keep something safe, use Mark areas on an image and paint it red (remove first) or green (keep). The Squishless guide explains every control and has tips for good results.
The repository also contains Squishless Studio, a lab for learning how seam carving works. It runs the original esimov/caire library step by step and streams every seam to the browser as it is removed, so you can watch the image shrink and see how each setting changes the result. It is much slower than Squishless and meant for exploring, not batch work.
go run ./cmd/squishless-studio # opens http://127.0.0.1:7777| Guide | Read it when you want to... |
|---|---|
| Getting started | Install Go, build and run the apps on Windows, macOS or Linux. |
| Squishless guide | Learn every control, with tips and the HTTP API for scripting. |
| Squishless Studio guide | Use the live seam-carving lab and its HTTP API. |
| How it works | Understand seam carving, why Squishless is ~50× faster than the reference library, and the library patch. |
| Troubleshooting & FAQ | Fix common problems and get better-looking results. |
| Development | Find your way around the code, run the tests, make releases. |
.
├── cmd/squishless/ Squishless: server, flags, embedded web UI (web/)
├── cmd/squishless-studio/ Squishless Studio: entry point, embedded web UI and samples
├── internal/fastcarve/ The fast seam-carving engine used by Squishless
├── internal/server/ Squishless Studio HTTP API, job runner, live frame streaming
├── third_party/caire/ esimov/caire v1.5.0, vendored with a small patch
└── docs/ Guides and screenshots
Issues and pull requests are welcome. Please run go vet ./... and go test ./...
before opening a pull request; Development has the details.
- Seam carving: Shai Avidan and Ariel Shamir, Seam Carving for Content-Aware Image Resizing (SIGGRAPH 2007).
- esimov/caire by Endre Simo (MIT License), vendored in
third_party/cairewith its license. Face detection uses esimov/pigo (MIT License). - Sample photos: see
cmd/squishless-studio/web/samples/CREDITS.txt.

