{"id":30720251,"url":"https://github.com/sonirico/zimg","last_synced_at":"2025-09-03T11:02:06.131Z","repository":{"id":310894670,"uuid":"1041656150","full_name":"sonirico/zimg","owner":"sonirico","description":"Fast image processing CLI tool powered by Zig and libvips. Designed for high-performance, SIMD batch operations and pipeline integration.","archived":false,"fork":false,"pushed_at":"2025-08-30T10:07:45.000Z","size":1792,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-30T12:10:56.479Z","etag":null,"topics":["cli","compress","convert","crop","image","image-processing","libvips","optimize","scale","simd","tool","ziglang"],"latest_commit_sha":null,"homepage":"","language":"Zig","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/sonirico.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}},"created_at":"2025-08-20T20:15:51.000Z","updated_at":"2025-08-30T10:07:48.000Z","dependencies_parsed_at":"2025-08-20T22:28:35.567Z","dependency_job_id":"e35b1d82-12d2-4519-a737-d256ddf4e63f","html_url":"https://github.com/sonirico/zimg","commit_stats":null,"previous_names":["sonirico/zimg"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/sonirico/zimg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonirico%2Fzimg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonirico%2Fzimg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonirico%2Fzimg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonirico%2Fzimg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sonirico","download_url":"https://codeload.github.com/sonirico/zimg/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sonirico%2Fzimg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273431417,"owners_count":25104496,"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","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"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":["cli","compress","convert","crop","image","image-processing","libvips","optimize","scale","simd","tool","ziglang"],"created_at":"2025-09-03T11:00:43.396Z","updated_at":"2025-09-03T11:02:05.448Z","avatar_url":"https://github.com/sonirico.png","language":"Zig","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"zimg.png\" alt=\"zimg logo\" title=\"zimg - Fast image processing CLI tool\" width=\"200\"/\u003e\n\n  # zimg\n  \n  Fast image processing CLI tool built with Zig and libvips. Designed for high-performance batch operations and pipeline integration.\n\n  [![Zig](https://img.shields.io/badge/Zig-0.14+-F7A41D?style=flat\u0026logo=zig\u0026logoColor=white)](https://ziglang.org/)\n  [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n  [![libvips](https://img.shields.io/badge/libvips-8.17+-4B8BBE?style=flat)](https://libvips.github.io/libvips/)\n  [![Release](https://img.shields.io/github/v/release/sonirico/zimg?style=flat)](https://github.com/sonirico/zimg/releases)\n\u003c/div\u003e\n\nFast image processing CLI tool built with Zig and libvips. Designed for high-performance batch operations and pipeline integration.\n\n## Installation\n\n### Quick install\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/sonirico/zimg/main/install.sh | bash\n```\n\n### Binary releases\n\nDownload the latest release for your platform:\n\n```bash\n# Linux x86_64\ncurl -L https://github.com/sonirico/zimg/releases/latest/download/zimg-linux-x86_64 -o zimg\nchmod +x zimg\n\n# macOS (Intel)\ncurl -L https://github.com/sonirico/zimg/releases/latest/download/zimg-darwin-x86_64 -o zimg\nchmod +x zimg\n\n# macOS (Apple Silicon)\ncurl -L https://github.com/sonirico/zimg/releases/latest/download/zimg-darwin-arm64 -o zimg\nchmod +x zimg\n\n# Windows\ncurl -L https://github.com/sonirico/zimg/releases/latest/download/zimg-windows-x86_64.exe -o zimg.exe\n```\n\n### Docker\n\n```bash\ndocker pull ghcr.io/sonirico/zimg:latest\ndocker run --rm -v $(pwd):/workspace ghcr.io/sonirico/zimg inspect /workspace/image.jpg\n```\n\n### From source\n\nRequires Zig 0.14+ and libvips development headers:\n\n```bash\n# Ubuntu/Debian\nsudo apt install libvips-dev\n\n# macOS\nbrew install vips\n\n# Build\ngit clone https://github.com/sonirico/zimg.git\ncd zimg\nzig build -Doptimize=ReleaseFast\n```\n\n## Usage\n\nAll commands support reading from stdin for pipeline operations:\n\n```bash\n# Basic inspection\nzimg inspect image.jpg\n\n# Pipeline usage\ncat image.jpg | zimg inspect\n\n# JSON output for scripting\nzimg inspect --json image.jpg | jq '.width'\n```\n\n### Commands\n\n**inspect** - Analyze image properties\n```bash\nzimg inspect photo.jpg\nzimg inspect --json photo.jpg  # JSON format\n```\n\n**optimize** - Compress images\n```bash\nzimg optimize --quality 85 --strip photo.jpg\nzimg optimize --palette photo.png  # Enable palette optimization\n```\n\n**crop** - Extract image regions\n```bash\nzimg crop photo.jpg 100 100 800 600  # x y width height\n```\n\n**scale** - Resize images\n```bash\nzimg scale photo.jpg 1920 1080\n```\n\n### Pipeline examples\n\n```bash\n# Batch optimization\nfind . -name \"*.jpg\" | xargs -I {} zimg optimize --quality 80 {}\n\n# Inspect multiple files\nfor img in *.jpg; do zimg inspect --json \"$img\"; done | jq '.size_bytes' | paste -sd+ | bc\n\n# Convert and optimize pipeline\ncat input.tiff | zimg optimize --quality 90 \u003e output.jpg\n```\n\n## Development Status\n\n### Implemented\n- [x] Basic CLI structure with zli framework\n- [x] Image inspection with full metadata\n- [x] libvips integration for format detection\n- [x] Pipeline support (stdin/stdout)\n- [x] JSON output format\n- [x] Error handling and validation\n\n### In Progress\n- [ ] Optimize command with compression options\n- [ ] Crop command with coordinate validation\n- [ ] Scale command with aspect ratio preservation\n\n### Planned\n- [ ] Format conversion (JPEG, PNG, WebP, AVIF)\n- [ ] Batch processing mode\n- [ ] Configuration file support\n- [ ] Progress bars for large operations\n- [ ] Color profile management\n- [ ] Watermarking capabilities\n- [ ] Advanced filters (blur, sharpen, etc.)\n- [ ] Multi-threading for batch operations\n- [ ] Plugin system for custom operations\n\n### Research\n- [ ] SIMD optimizations\n- [ ] WebAssembly target\n- [ ] GPU acceleration integration\n- [ ] Streaming processing for large files\n\n## Contributing\n\nThis project uses Zig 0.14 and follows standard practices. PRs welcome for bug fixes and feature implementations from the TODO list.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonirico%2Fzimg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsonirico%2Fzimg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsonirico%2Fzimg/lists"}