{"id":29301429,"url":"https://github.com/sunjay-dev/image-format-converter","last_synced_at":"2025-07-06T22:10:17.822Z","repository":{"id":301092118,"uuid":"1007923970","full_name":"sunjay-dev/Image-Format-Converter","owner":"sunjay-dev","description":"A CLI tool to convert images formats with features like quality control, batch mode, and more.","archived":false,"fork":false,"pushed_at":"2025-06-25T05:04:44.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T05:33:24.010Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/sunjay-dev.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"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,"zenodo":null}},"created_at":"2025-06-24T18:39:35.000Z","updated_at":"2025-06-25T05:04:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"14d3aec8-c825-4fd4-bcdb-98980e020f42","html_url":"https://github.com/sunjay-dev/Image-Format-Converter","commit_stats":null,"previous_names":["sunjay-dev/image-format-converter"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sunjay-dev/Image-Format-Converter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FImage-Format-Converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FImage-Format-Converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FImage-Format-Converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FImage-Format-Converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sunjay-dev","download_url":"https://codeload.github.com/sunjay-dev/Image-Format-Converter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FImage-Format-Converter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263980177,"owners_count":23538922,"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":[],"created_at":"2025-07-06T22:10:17.559Z","updated_at":"2025-07-06T22:10:17.811Z","avatar_url":"https://github.com/sunjay-dev.png","language":"JavaScript","readme":"# 🖼️ Imgify - Image Format Converter\n\n\u003cimg src=\"https://raw.githubusercontent.com/sunjay-dev/Image-format-converter/refs/heads/main/assets/preview.webp\" alt=\"SolarVerse Preview\" width=\"100%\" /\u003e\n\n\nA simple and powerful CLI tool to **convert images** to different formats like WebP, JPEG, PNG, AVIF, and more — powered by [Sharp](https://github.com/lovell/sharp).\n\n---\n\n## 🚀 Features\n- ✅ Convert a single image or **batch convert all** in a folder\n- 🎯 Format support: `webp`, `jpeg`, `png`, `avif`, `tiff`, `gif`\n- 🎚️ Control output quality (`-quality=80`)\n- 🔍 Filter files by extension (`-ext=jpg`)\n- 🗑️ Delete original files after conversion (`-del`)\n* 🧪 **preview run** support — see what will be converted (`-preview`)\n\n---\n\n\n\n### 📦 Installation \u0026 Usage\n\n### 🚀 One-liner (No install needed):\n\n```bash\nnpx imgify-cli input.png output.jpeg\n```\n\nYou can use all options like:\n\n```bash\nnpx imgify-cli -all -ext=png -f=webp -quality=80\n```\n\nThis is the **recommended way** to use `imgify-cli` quickly and without setup.\n\n---\n\n### 💻 Local Development or Manual Global Setup (For Offline Use or Contribution)\n\n#### 🔧 Manual setup (if you want to contribute or link locally):\n\n1. Clone the repo: (Open Terminal as **Administrator**)\n\n```bash\ngit clone https://github.com/sunjay-dev/Image-Format-Converter\n```\n\n2. Enter the directory:\n\n```bash\ncd Image-Format-Converter\n```\n\n3. Install dependencies:\n\n```bash\nnpm install\n```\n\n4. Link globally:\n\n```bash\nnpm link\n```\n\n\u003e Now you can run `imgify` anywhere.\n\n---\n\n## 🧑‍💻 Usage\n\n### ➤ Convert a single image\n\n```bash\nimgify input.jpg output.png\n```\n\n### ➤ Convert with a custom output\n\n```bash\nimgify input.jpg output.webp\n```\n\n### ➤ Convert all images in the current folder\n\n```bash\nimgify -all\n```\n\n### ➤ Convert only `.png` images\n\n```bash\nimgify -all -ext=png\n```\n\n### ➤ Convert and delete original files\n\n```bash\nimgify -all -del\n```\n\n### ➤ Preview conversion (preview run)\n\n```bash\nimgify -all --preview\n```\n\n---\n\n## 🔧 Options\n\n| Flag           | Description                                                  | Default |\n| -------------- | ------------------------------------------------------------ | ------- |\n| `-all`         | Convert all `.jpg`, `.jpeg`, `.png` in current folder        | —       |\n| `-quality=80`  | Output quality (0–100, lossy formats only)                   | `80`    |\n| `-format=webp` | Output format: `webp`, `jpeg`, `png`, `avif`, `tiff`         | `webp`  |\n| `-ext=png`     | Only convert files with the specified extension              | all     |\n| `-del`         | Delete the original file(s) after conversion                 | off     |\n| `-preview`     | Simulate conversion (log what would be converted)            | off     |\n| `-help`        | Show usage instructions                                      | —       |\n\n---\n\n## 🧪 Examples\n\n```bash\nimgify input.jpg -format=avif -quality=70\nimgify -all -ext=jpeg -format=png -del\nimgify input.png output.avif -quality=90\nimgify -all -preview\n```\n\n---\n\n## 📂 Supported Formats\n\n* **Input**: `.jpg`, `.jpeg`, `.png`, `.webp`, `.tiff`, `.gif`, `.avif`\n* **Output**: `webp`, `jpeg`, `png`, `avif`, `tiff`\n\n\u003e Internally uses [Sharp](https://www.npmjs.com/package/sharp) for fast, high-quality conversions.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsunjay-dev%2Fimage-format-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsunjay-dev%2Fimage-format-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsunjay-dev%2Fimage-format-converter/lists"}