Skip to content

fluffycc/cropkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 

Repository files navigation

CropKit 🖼️

A lightweight, zero-install photo cropping and resizing tool that runs entirely in your browser as a single HTML file. No server, no dependencies, no account required.

Features

Mode What it does
📐 Pixel Crop Crop to an exact pixel size (e.g. 800×600). Drag the fixed-size box to position it on your image.
✂️ Ratio Crop Freehand drag with an optional aspect ratio lock — presets for 1:1, 4:3, 16:9, 9:16, or any custom ratio.
💾 File Size Resize the whole image to fit under a target file size (KB or MB). Outputs JPEG, WebP, or PNG.
🛂 Passport Crop to country/document photo presets with DPI-based output and an alignment guide.
Live Preview See pixel, ratio, and file-size output previews in the sidebar before downloading.
View Controls Zoom, pan, and adjust selections with mouse, trackpad, or touch.

How to Use

  1. Download CropKit.html
  2. Double-click it — it opens in your default browser
  3. Drag & drop a photo onto the window, or click Open Image
  4. Pick a mode from the top tabs, set your options, preview the crop, and click Crop & Download

That's it. CropKit remembers your last settings and downloads files using your original image name.

Supported Input Formats

JPG · PNG · WebP · GIF · BMP · TIFF (anything your browser can display)

Crop Modes in Detail

Pixel Crop

Enter exact output dimensions in pixels. A selection box of that exact size appears centered on the image. Drag it to reposition, choose JPEG / PNG / WebP, or use the selection tools to center, fit the source image, swap width/height, or reset defaults.

Quick presets: 1920×1080, 1280×720, 1080×1080, 800×600, 512×512, 400×300

Ratio Crop

Drag a selection on the image. Choose a preset ratio or enter a custom W:H value to constrain the drag. Set to No Lock for an unconstrained selection. Drag the corner/edge handles to adjust, choose JPEG / PNG / WebP, or use the selection tools to center, fit, swap, or reset the crop.

Presets: No Lock, 1:1, 4:3, 3:4, 16:9, 9:16

File Size Resize

No manual selection needed. Enter a target size (e.g. 500 KB or 2 MB) and choose your output format. CropKit binary-searches the optimal quality setting, then scales down the image dimensions if needed to hit the target.

  • JPEG / WebP — best compression, lossy
  • PNG — lossless, larger files; only dimension scaling is used

Passport Photo

Choose a country/document preset, set the print DPI, and crop with the passport guide overlay. CropKit exports the selected crop at the preset output size and names the file with the original image name plus the preset country.

Starter presets include:

United States 2×2in, United Kingdom 35×45mm, Canada 50×70mm, Australia 35-40×45-50mm (35×45mm preset), India 35×45mm, China visa/photo 33×48mm, France 35×45mm, Japan 35×45mm, and New Zealand digital 900×1200px.

Important: passport and visa rules also include face size, background, lighting, age of photo, retouching, and print-paper requirements. The guide is an alignment aid, not a compliance checker. Always verify the current official requirements before submitting.

View Controls

Use the sidebar view controls to zoom in, zoom out, reset to fit, or switch into pan mode. Mouse wheel / trackpad scrolling zooms around the pointer, and the canvas supports touch dragging on mobile and tablet screens.

Technical Notes

  • Entirely client-side — your images never leave your device
  • No external libraries or CDN calls
  • Works offline after the file is downloaded
  • Canvas-based rendering with a rule-of-thirds overlay and live pixel readout
  • Last-used crop settings are stored locally in your browser

License

MIT — use it, modify it, share it freely.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages