{"id":51058629,"url":"https://github.com/rudra-mondal/batch-image-cropper","last_synced_at":"2026-06-22T23:30:35.837Z","repository":{"id":362224107,"uuid":"1245918555","full_name":"rudra-mondal/batch-image-cropper","owner":"rudra-mondal","description":"A desktop batch image cropping tool for quickly preparing multiple images at a consistent size and aspect ratio.","archived":false,"fork":false,"pushed_at":"2026-06-03T06:30:21.000Z","size":558,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T08:25:36.818Z","etag":null,"topics":["gui","image-cropper","image-processing","pillow","pyside6","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rudra-mondal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-21T17:30:41.000Z","updated_at":"2026-06-03T06:30:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rudra-mondal/batch-image-cropper","commit_stats":null,"previous_names":["rudra-mondal/batch-image-cropper"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/rudra-mondal/batch-image-cropper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudra-mondal%2Fbatch-image-cropper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudra-mondal%2Fbatch-image-cropper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudra-mondal%2Fbatch-image-cropper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudra-mondal%2Fbatch-image-cropper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rudra-mondal","download_url":"https://codeload.github.com/rudra-mondal/batch-image-cropper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudra-mondal%2Fbatch-image-cropper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34669839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["gui","image-cropper","image-processing","pillow","pyside6","python"],"created_at":"2026-06-22T23:30:35.382Z","updated_at":"2026-06-22T23:30:35.829Z","avatar_url":"https://github.com/rudra-mondal.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Batch Image Cropper\n\nA desktop batch image cropping tool for quickly preparing multiple images at a consistent size and aspect ratio.\n\nBuilt with **Python**, **PySide6**, and **Pillow**, the app gives you a visual crop preview, mouse-based pan/zoom controls, target output dimensions, DPI-aware physical units, and one-click batch export.\n\n![Batch Image Cropper app UI](docs/Screenshot.png)\n\n## Features\n\n- Drag and drop multiple images into the app\n- Preview each image with a fixed crop overlay\n- Pan and zoom while the image stays constrained to the crop area\n- Rule-of-thirds grid for easier composition\n- Set target dimensions in pixels, inches, or centimeters\n- Configure DPI for print-oriented exports\n- Confirm crops one by one, then save all processed images together\n- Preserves common image formats including JPG, JPEG, PNG, BMP, and TIFF\n- Applies EXIF auto-rotation when loading images\n\n## Requirements\n\n- Python 3.10 or newer recommended\n- Windows, macOS, or Linux with a desktop environment supported by Qt\n\nPython dependencies are listed in [`requirements.txt`](requirements.txt).\n\n## Installation\n\nClone the repository:\n\n```bash\ngit clone https://github.com/rudra-mondal/batch-image-cropper.git\ncd batch-image-cropper\n```\n\nCreate and activate a virtual environment:\n\n```bash\npython -m venv .venv\n```\n\nOn Windows PowerShell:\n\n```powershell\n.\\.venv\\Scripts\\Activate.ps1\n```\n\nOn macOS or Linux:\n\n```bash\nsource .venv/bin/activate\n```\n\nInstall dependencies:\n\n```bash\npip install -r requirements.txt\n```\n\n## Run the App\n\n```bash\npython app.py\n```\n\n## How to Use\n\n1. Launch the app.\n2. Drag and drop image files into the window.\n3. Select an image from the **Uncropped Images** list.\n4. Set the target width, height, units, and DPI.\n5. Use the mouse wheel to zoom and drag the image to position it inside the crop frame.\n6. Click **Confirm \u0026 Next** to queue the crop.\n7. Repeat for the remaining images.\n8. Click **Save All...** and choose an output folder.\n\nExported files are saved with `_cropped` added to the original filename.\n\n## Build an Executable\n\nThis project includes PyInstaller in its dependencies. If you want to create a distributable desktop build, run:\n\n```bash\npyinstaller Precision_Batch_Cropper.spec\n```\n\nThe generated build files will be placed in `build/` and `dist/`.\n\n## Project Structure\n\n```text\n.\n|-- app.py\n|-- requirements.txt\n|-- docs/\n|   `-- Screenshot.png\n`-- README.md\n```\n\n## Tech Stack\n\n- [PySide6](https://doc.qt.io/qtforpython-6/) for the desktop interface\n- [Pillow](https://python-pillow.org/) for image cropping, resizing, and saving\n- [PyInstaller](https://pyinstaller.org/) for optional executable builds\n\n## License\n\nThis project is licensed under the MIT License. See [`LICENSE`](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudra-mondal%2Fbatch-image-cropper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frudra-mondal%2Fbatch-image-cropper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudra-mondal%2Fbatch-image-cropper/lists"}