dhaizon/imagecrop.koplugin

imagecrop.koplugin is a plugin for KOReader, the popular open-source e-reader software used on devices like Kindles and Kobos. It adds a crop tool directly into KOReader's built-in Image Viewer, letting you select a rectangular piece of any image you are looking at and save just that piece as its own picture file. To use it, you open an image inside KOReader, tap a new Crop button that the plugin adds to the viewer, then tap once on the image to set one corner of your selection and tap again to set the opposite corner. A visible black and white bordered rectangle with corner markers shows your selection clearly, even on the black and white e-ink screens these devices use. If you need to adjust the selection precisely, arrow buttons let you nudge the whole rectangle one pixel at a time before you finish. Once you are happy with the selection, you can save it as a PNG image, which the plugin places in the same folder as the original image with a timestamped filename, or in a screenshots folder if the original image has no file path. The original image itself is never changed. There is also a Reset option to clear the current selection and start over, and a Cancel option to leave crop mode entirely. The plugin also works together with a companion plugin called pinnedelements.koplugin, which lets you pin pages, text, and images to a persistent list while reading. If that plugin is installed too, a Pin button becomes available in the crop tool, letting you send a cropped image directly into your pinned items list without saving a separate file first. The two plugins are designed so that both add their own buttons to the Image Viewer without interfering with each other, in whatever order they load. Installation can be done either through an app store plugin for KOReader that automatically downloads and installs it, or by transferring the plugin folder over Wi-Fi to the device's plugins directory using a file browser plugin, then restarting KOReader. The README notes the plugin was built with help from Claude, Anthropic's AI assistant.