{"id":25319414,"url":"https://github.com/jerry4rahul/capacitor-image-cropper","last_synced_at":"2026-02-23T02:05:49.821Z","repository":{"id":277126620,"uuid":"915577198","full_name":"jerry4rahul/capacitor-image-cropper","owner":"jerry4rahul","description":"A Capacitor plugin that enables image cropping functionality using the popular UCrop library. Supports aspect ratio settings, resizing, and high-quality output for Android. ","archived":false,"fork":false,"pushed_at":"2025-01-12T08:24:00.000Z","size":116,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-12T09:48:38.201Z","etag":null,"topics":["android","capacitor","capacitor-plugin","image-cropper","image-cropping-tool","ionic","ionic-framework","ucrop"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jerry4rahul.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-12T08:23:56.000Z","updated_at":"2025-02-04T19:05:10.000Z","dependencies_parsed_at":"2025-02-12T09:48:42.467Z","dependency_job_id":"e19d18f2-95ff-4f1b-b09a-f5d90a6bf702","html_url":"https://github.com/jerry4rahul/capacitor-image-cropper","commit_stats":null,"previous_names":["jerry4rahul/capacitor-image-cropper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry4rahul%2Fcapacitor-image-cropper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry4rahul%2Fcapacitor-image-cropper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry4rahul%2Fcapacitor-image-cropper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerry4rahul%2Fcapacitor-image-cropper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jerry4rahul","download_url":"https://codeload.github.com/jerry4rahul/capacitor-image-cropper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238726195,"owners_count":19520166,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","capacitor","capacitor-plugin","image-cropper","image-cropping-tool","ionic","ionic-framework","ucrop"],"created_at":"2025-02-13T20:20:53.683Z","updated_at":"2025-10-28T21:31:08.282Z","avatar_url":"https://github.com/jerry4rahul.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## 🌟 Available Now on Android, with iOS Support Coming Soon! 🌟\n\n# 🎨 Capacitor Image Cropper\n\nThe **Capacitor Image Cropper** plugin offers a powerful and user-friendly way to crop images in your mobile applications. With this plugin, you can effortlessly select and crop images to meet your desired dimensions, ensuring your app looks polished and professional! ✨\n\n## 🚀 Features\n\n- **Flexible Cropping Options**: Crop images with customizable width, height, and aspect ratios. 📏\n- **Quality Control**: Adjust the quality of the resulting image, balancing fidelity and file size. 📸\n- **Circle Cropping**: Optionally crop images in a circular shape for a unique visual flair. 🔵\n- **Cross-Platform Support**: Works seamlessly on both iOS and Android platforms. 📱\n- **uCrop Integration**: For Android, we utilize the powerful **uCrop** library, providing a robust and feature-rich cropping experience. 🎉\n\n## 📚 Usage\n\nTo get started with the Capacitor Image Cropper plugin, simply install it in your project and follow the provided documentation for implementation details.\n\nTransform your images effortlessly with the **Capacitor Image Cropper** plugin! 🌈\n\n### 🛠️ Adding JitPack Repository\n\nTo add the JitPack repository, navigate to your `android/gradle.build` file and include the following configuration:\n\n```bash\nallprojects {\n    repositories {\n        google()\n        mavenCentral()\n        maven { url \"https://jitpack.io\" }\n    }\n}\n```\n\n## 📦 Install\n\nRun the following commands to install the plugin:\n\n```bash\nnpm install capacitor-image-cropper\nnpx cap sync\n```\n\n## 📖 API\n\n\u003cdocgen-index\u003e\n\n* [`crop(...)`](#crop)\n* [Interfaces](#interfaces)\n\n\u003c/docgen-index\u003e\n\n\u003cdocgen-api\u003e\n\u003c!--Update the source file JSDoc comments and rerun docgen to update the docs below--\u003e\n\n### crop(...)\n\n```typescript\ncrop(options: CropOptions) =\u003e Promise\u003cCropResult\u003e\n```\n\n| Param         | Type                                                |\n| ------------- | --------------------------------------------------- |\n| **`options`** | \u003ccode\u003e\u003ca href=\"#cropoptions\"\u003eCropOptions\u003c/a\u003e\u003c/code\u003e |\n\n**Returns:** \u003ccode\u003ePromise\u0026lt;\u003ca href=\"#cropresult\"\u003eCropResult\u003c/a\u003e\u0026gt;\u003c/code\u003e\n\n--------------------\n\n\n### Interfaces\n\n\n#### CropResult\n\n| Prop         | Type                | Description                                                                             |\n| ------------ | ------------------- | --------------------------------------------------------------------------------------- |\n| **`path`**   | \u003ccode\u003estring\u003c/code\u003e | The path to the cropped image On Android: content:// or file:// URI On iOS: file:// URI |\n| **`base64`** | \u003ccode\u003estring\u003c/code\u003e | Base64 encoded image data (optional, web only)                                          |\n\n\n#### CropOptions\n\n| Prop                            | Type                 | Description                                                                                   | Default                |\n| ------------------------------- | -------------------- | --------------------------------------------------------------------------------------------- | ---------------------- |\n| **`source`**                    | \u003ccode\u003estring\u003c/code\u003e  | The path or url of the image to crop Can be a local file path, content:// uri, or file:// uri |                        |\n| **`quality`**                   | \u003ccode\u003enumber\u003c/code\u003e  | Quality of the resulting image, between 0-100                                                 | \u003ccode\u003e90\u003c/code\u003e        |\n| **`circle`**                    | \u003ccode\u003eboolean\u003c/code\u003e | Whether to crop the image in a circle                                                         | \u003ccode\u003efalse\u003c/code\u003e     |\n| **`width`**                     | \u003ccode\u003enumber\u003c/code\u003e  | Maximum width of the resulting image                                                          | \u003ccode\u003e300\u003c/code\u003e       |\n| **`height`**                    | \u003ccode\u003enumber\u003c/code\u003e  | Maximum height of the resulting image                                                         | \u003ccode\u003e300\u003c/code\u003e       |\n| **`aspectRatioX`**              | \u003ccode\u003enumber\u003c/code\u003e  | Aspect ratio X for crop box (width/height) e.g., 1 for square                                 | \u003ccode\u003e1\u003c/code\u003e         |\n| **`aspectRatioY`**              | \u003ccode\u003enumber\u003c/code\u003e  | Aspect ratio Y for crop box (height/width) e.g., 1 for square                                 | \u003ccode\u003e1\u003c/code\u003e         |\n| **`activeControlsWidgetColor`** | \u003ccode\u003estring\u003c/code\u003e  | Color of the active controls widget                                                           | \u003ccode\u003e\"#9ef500\"\u003c/code\u003e |\n\n\u003c/docgen-api\u003e\n\n---\n\n## 👤 Author\n\n[**Rahul Kumar Sharma**](https://github.com/jerry4rahul)\n\nPassionate developer and creator of the Capacitor Image Cropper plugin.\n\n## 💬 Message\n\nThank you for using the Capacitor Image Cropper! Your feedback and contributions are always welcome. Let's make image cropping a breeze for everyone! 🌟\n\n## 🤝 Collaboration\n\nWe welcome collaboration! If you have ideas, suggestions, or would like to contribute to the project, feel free to reach out or submit a pull request. Together, we can enhance this plugin and make it even better! 🚀\n\n---\n\n### 🎉 Special Thanks\n\nA big shoutout to the [**uCrop**](https://github.com/Yalantis/uCrop) library for providing an excellent cropping experience on Android! Your contributions make this plugin even more powerful! 🙌\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerry4rahul%2Fcapacitor-image-cropper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjerry4rahul%2Fcapacitor-image-cropper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerry4rahul%2Fcapacitor-image-cropper/lists"}