Skip to content

About

Resize images without squishing what matters: fast content-aware (seam carving) resizing as a local web app, plus a live seam-carving lab.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Squishless

CI

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.

Squishless with the before/after slider

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).

Download

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.

Build from source

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:7878

Or build a standalone program:

go build -o squishless.exe ./cmd/squishless   # drop .exe on macOS / Linux

Getting started has the full setup, cross-compiling and the command-line options.

Using it in 30 seconds

  1. Drop one or more images on the page (or click choose files, or paste with Ctrl+V).
  2. Pick a size: Exact (for example 1080 × 1080), Percent, Fit width or Fit height, or click a preset.
  3. Press Resize all (Ctrl+Enter).
  4. 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.

Squishless Studio

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

Squishless Studio carving live

Documentation

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.

Project layout

.
├── 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

Contributing

Issues and pull requests are welcome. Please run go vet ./... and go test ./... before opening a pull request; Development has the details.

Credits

About

Resize images without squishing what matters: fast content-aware (seam carving) resizing as a local web app, plus a live seam-carving lab.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages