Skip to content

Crop Wizard can crop and resize images right in your browser. Simply open your image, resize the crop area, and save! Works with PNG, JPG, or webp images. Works offline and locally.

License

Notifications You must be signed in to change notification settings

dgendill/crop-wizard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Crop Wizard

Overview

Ever feel like cropping and resizing images isn't as convenient as it should be? Crop Wizard can crop and resize images right in your browser. Simply open your image, resize the crop area, and save! The goal of Crop Wizard to make cropping and resizing as easy as possible.

Crop Wizard is free software released under the GNU General Public License V3.

Features

  • Crop and resize PNG, JPG, and webp images
  • Freeform Crop
  • Crop with aspect ratio constraints
  • Crop with a fixed size
  • Works on Desktop or Mobile
  • Standalone HTML file that can be used offline and saved to your desktop or mobile device.

Getting Started

The latest version of Crop Wizard can be found at https://www.dgendill.com/content/crop-wizard/ or downloaded from release/index.html.

If you'd like to build crop-wizard yourself, you'll need Node.js >= 4. Simply run npm run build to build release/index.html file. Then open the release/index.html file in your browser.

Project Structure

HTML and JavaScript source files can be found in the src directory. The dev.html file is the application itself, and crop_canvas.js contains the code for the image editor containing the crop window.

Development

If you'd like to add features or modify Crop Wizard in some way, simply open src/dev.html in your browser. Edit the dev.html or crop_canvas.js files and then refresh the page.

Design

The Crop Wizard logos can be found in crop-wizard-project.svg

Testing

Crop Wizard has been tested manually on:

  • Desktop chrome
  • Desktop Firefox
  • Desktop webkit
  • Mobile android chrome + brave

If you run into an issues I would appreciate it if you filed a bug report in the issues tab.

There are also automated tests with playwright. To run the playwright tests you'll need Node.js >=18. Run npm install in the project root. Then run npm run test.

If you'd like to write some new tests or troubleshoot interactively you can open the playwright UI by running npm run test -- --ui. There are several other playwright commands you can run, see the playwright-notes.txt file.

Contributing

If you'd like to report a bug or give feedback or suggestions feel free to open a ticket in the Github issues tab.

License

Crop Wizard is released under the GNU General Public License V3. See LICENSE.md for the full license.

Acknowledgements

Special thanks to the Mozilla Corporation and Mozilla's MDN team for the excellent document on MDN as well as the World Wide Web Consortium and all the developers who implement those browser standards.

Thanks to https://www.favicon-generator.org/

Contact

About

Crop Wizard can crop and resize images right in your browser. Simply open your image, resize the crop area, and save! Works with PNG, JPG, or webp images. Works offline and locally.

Resources

License

Stars

Watchers

Forks

Packages

No packages published