{"id":19902591,"url":"https://github.com/johnbasrai/mirage","last_synced_at":"2026-06-10T19:31:17.446Z","repository":{"id":174557072,"uuid":"587150519","full_name":"JohnBasrai/mirage","owner":"JohnBasrai","description":"🖼️ High-performance Rust CLI for image editing and fractal generation — supports blur, crop, grayscale, rotate, and more","archived":false,"fork":false,"pushed_at":"2025-06-21T23:03:32.000Z","size":1183,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-21T23:18:55.571Z","etag":null,"topics":["clap","cli","create-crate","github-actions","image-processing","image-rs","integration-testing","rust","unittest"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/JohnBasrai.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}},"created_at":"2023-01-10T04:26:25.000Z","updated_at":"2025-06-21T23:11:05.000Z","dependencies_parsed_at":"2025-01-11T21:21:39.273Z","dependency_job_id":"23e3aafc-1e54-4664-af38-be9eced6da2a","html_url":"https://github.com/JohnBasrai/mirage","commit_stats":null,"previous_names":["johnbasrai/mirage"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/JohnBasrai/mirage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnBasrai%2Fmirage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnBasrai%2Fmirage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnBasrai%2Fmirage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnBasrai%2Fmirage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JohnBasrai","download_url":"https://codeload.github.com/JohnBasrai/mirage/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JohnBasrai%2Fmirage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34168086,"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-10T02:00:07.152Z","response_time":89,"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":["clap","cli","create-crate","github-actions","image-processing","image-rs","integration-testing","rust","unittest"],"created_at":"2024-11-12T20:18:35.161Z","updated_at":"2026-06-10T19:31:17.441Z","avatar_url":"https://github.com/JohnBasrai.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mirage 🌟\n\nA fast and simple command-line image processing tool written in Rust. Mirage provides essential image manipulation operations with an intuitive interface.\n\n## Features\n\n| Feature | Description |\n|---------|-------------|\n| **Blur** | Apply gaussian blur with configurable intensity (0-100%) |\n| **Brighten** | Adjust image brightness with positive or negative values |\n| **Crop** | Extract rectangular regions from images |\n| **Rotate** | Rotate images by 90°, 180°, or 270° |\n| **Invert** | Create negative images by inverting colors |\n| **Grayscale** | Convert color images to grayscale |\n| **Fractal** | Generate beautiful fractal images |\n| **Generate** | Create solid color images *(coming soon)* |\n\n## Installation\n\n### From Source\n\n```bash\ngit clone https://github.com/yourusername/mirage.git\ncd mirage\ncargo build --release\n```\n\nThe binary will be available at `target/release/mirage`.\n\n### Prerequisites\n\n- Rust 1.70+ (2021 edition)\n- Cargo package manager\n\n## Usage\n\n```bash\nmirage \u003cCOMMAND\u003e [OPTIONS]\n```\n\n### Examples\n\n```bash\n# Blur the image\ncargo run -- blur Test_Image.PNG blurred.png 10\n\n# Convert to grayscale  \ncargo run -- grayscale Test_Image.PNG gray.png\n\n# Generate a fractal\ncargo run -- fractal my_fractal.png 400 400\n```\n\n### Available Commands\n\n| Command | Description | Arguments |\n|---------|-------------|-----------|\n| `blur` | Apply gaussian blur | `\u003cinfile\u003e \u003coutfile\u003e \u003cpercent\u003e` |\n| `brighten` | Adjust brightness | `\u003cinfile\u003e \u003coutfile\u003e \u003camount\u003e` |\n| `crop` | Extract image region | `\u003cinfile\u003e \u003coutfile\u003e \u003cx\u003e \u003cy\u003e \u003cwidth\u003e \u003cheight\u003e` |\n| `rotate` | Rotate image | `\u003cinfile\u003e \u003coutfile\u003e \u003cdegrees\u003e` |\n| `invert` | Invert colors | `\u003cinfile\u003e \u003coutfile\u003e` |\n| `grayscale` | Convert to grayscale | `\u003cinfile\u003e \u003coutfile\u003e` |\n| `fractal` | Generate fractal | `\u003coutfile\u003e \u003cwidth\u003e \u003cheight\u003e` |\n| `generate` | Create solid color image | `\u003coutfile\u003e \u003cvalue\u003e` *(coming soon)* |\n\n### Help\n\n```bash\n# General help\nmirage --help\n\n# Command-specific help\nmirage blur --help\n```\n\n## Supported Image Formats\n\nMirage supports common image formats including:\n- JPEG/JPG\n- PNG\n- BMP\n- TIFF\n- WebP\n- And more via the `image` crate\n\n## Development\n\n## Tips\n\n- Generated images can be viewed in any web browser or image viewer\n- Use different file extensions (.png, .jpg, .bmp) as needed for output\n- The tool automatically detects input format and can convert between formats\n\n### Building\n\n```bash\ncargo build\n```\n\n### Running Tests\n\n```bash\ncargo test\n```\n\n### Running in Development\n\n```bash\ncargo run -- \u003ccommand\u003e [args]\n```\n\nExample:\n```bash\ncargo run -- blur test.jpg blurred.jpg 25\n```\n\n## Dependencies\n\n- [`image`](https://crates.io/crates/image) - Image processing library\n- [`clap`](https://crates.io/crates/clap) - Command line argument parsing\n- [`anyhow`](https://crates.io/crates/anyhow) - Error handling\n- [`num-complex`](https://crates.io/crates/num-complex) - Complex number support for fractals\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues and pull requests.\n\n### TODO\n\n- [ ] Implement the `generate` command\n- [ ] Add more image filters (sharpen, contrast, etc.)\n- [ ] Support for batch processing\n- [ ] Add configuration file support\n- [ ] Implement additional fractal types\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Fractal generation code adapted from [PistonDevelopers/image](https://github.com/PistonDevelopers/image)\n- Built with the excellent Rust `image` crate\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnbasrai%2Fmirage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnbasrai%2Fmirage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnbasrai%2Fmirage/lists"}