TOCropViewController is a view controller for iOS that allows users to crop and rotate portions of UIImage objects.
The tool addresses the need for in-app image cropping with an interface modeled after the iOS Photos app editor. It presents a modal view controller where users drag grid overlay edges to define crop regions, optionally constrain to specific aspect ratios, and rotate images in 90-degree increments. The cropped result can be returned to a delegate or passed directly to a UIActivityViewController for sharing. The tool supports both circular and rectangular crops, includes a reset button to undo changes, and applies translucency effects to clarify the cropped region during editing.
Developers building iOS apps that require image editing—such as profile picture editors or photo-sharing features—should consider this tool if they need straightforward cropping without heavy customization. The project provides two interfaces: TOCropViewController for Objective-C projects and CropViewController, a native Swift wrapper that offers a more idiomatic API for Swift developers. Installation is flexible, supporting CocoaPods, Swift Package Manager, Carthage, and manual integration. The tool requires iOS 12.0 or above and includes localization for 28 languages. For projects needing advanced capabilities like video editing or photo filters, the README suggests considering alternative solutions.
Development activity shows consistent maintenance with regular updates addressing compatibility and user-reported issues. The project demonstrates responsiveness to community contributions and maintains clear documentation for both Objective-C and Swift adoption paths. Pull requests for visionOS and Mac Catalyst support are welcomed, indicating openness to platform expansion despite these modes not being officially supported.
