Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


CropTool is a tool for cropping image files at Wikimedia Commons and other Wikimedia sites using the MediaWiki API with OAuth. Help page on Commons.

  • Supports JPEG, PNG and (animated) GIF files, and also single pages from DJVU and PDF files.
  • JPEGs can be cropped either losslessly using jpegtran or pixel perfect using ImageMagick.
  • Crop preview can be initialized from query string parameters: ?title=Example.jpg&left=10&top=10&width=150&height=100 or ?title=Example.jpg&left=10&top=10&right=10&bottom=10
  • Detects {{Remove border}}, Category:Images with borders, {{Watermark}} and {{Trimming}}, and provides check boxes for optional removal of these upon cropping.
  • The result can replace the original file or be uploaded as a new one.
  • If the result is uploaded as a new file on Wikimedia Commons,
  • Stops users from cropping images waiting for license review (having {{Flickrreview}} without any parameters, or some of the User:FlickreviewR subtemplates), since images should be reviewed before being altered.
  • Adds {{Orphaned non-free revisions}} when cropping non-free media on English Wikipedia.

Setting up a development environment

  1. Request an OAuth 1.0 consumer at with
  • Callback URL: https://localhost:7878/
  • Allow consumer to specify a callback in requests
  • Grants: "Edit existing pages", "Create, edit, and move pages", "Upload new files" and "Upload, replace, and move files"
  1. Copy config.dist.ini to config.ini and add the consumer token and secret token to config.ini

  2. Install dependencies using Composer and NPM:

composer install
npm install
  1. Build the frontend:
npx gulp build
  1. Generate secret for encrypted cookies:
php generate-key.php
  1. Start the development server on https://localhost:7878/
docker-compose up

Note that you should be able to login and preview cropping without waiting for the OAuth consumer to be accepted.

Deployment notes

To get jpegtran, we fetch the latest from the Independent JPEG Group. Note that the server returns "403 Forbidden" if you use the default curl user agent string.

curl -A "CropTool/0.1 (" "" | tar -xz
cd jpeg-*
make test

Download deps and configure croptool:

  1. composer install --optimize-autoloader
  2. cp config.dist.ini config.ini and insert OAuth info and the path to jpegtran.
  3. Check that the server can write to logs and public_html/files.
  4. vendor/bin/phpunit
  5. crontab to setup cronjobs.
  6. php generate-key.php

Frontend build:

On Toolforge, to use an up-to-date version of Node for installing dependencies, run:

$ webservice --backend=kubernetes node10 shell

This should start a new shell, from which you can run:

$ npm install npm
$ gulp build


Tool for cropping images at Wikimedia Commons and other Wikimedia wikis




No releases published


No packages published