Skip to content

danmichaelo/croptool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CropTool

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

Features:

  • Supports JPEG, PNG, SVG 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 https://meta.wikimedia.org/wiki/Special:OAuthConsumerRegistration/propose 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.dev.ini to config.ini and add the consumer token and secret token to config.ini and check the default paths for the dependencies.

  2. Install dependencies using Composer and NPM:

docker compose run phpfpm composer install
npm install
  1. Build the frontend:
npx gulp build
  1. Generate secret for encrypted cookies:
docker compose run phpfpm 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

  • ssh tools-login.wmflabs.org
  • become croptool
  • git pull
  • toolforge build start https://github.com/danmichaelo/croptool.git
  • toolforge webservice --backend=kubernetes --mount=all buildservice restart

First-time setup:

  • Copy config.prod.ini into the home directory, and add OAuth information
  • Creates a public_files directory in the home directory and set it to be readable and writable by others

About

Tool for cropping images at Wikimedia Commons and other Wikimedia wikis

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published