HEIC KoroScript

日本語README

A simple shell script to convert HEIC (HEIF) images to PNG or JPEG — quickly, recursively, and safely.
It automatically detects whether you have heif-convert (libheif) or ImageMagick installed.

---

🧠 Features

• Convert HEIC / HEIF → PNG or JPEG
• Supports multiple files and directories
• Recursive mode (-r)
• Adjustable JPEG quality (-q)
• Custom output directory (-o)
• Automatically uses heif-convert or magick depending on your system

---

⚙️ Installation

Make sure you have the required tools:

macOS (Homebrew)

brew install libheif imagemagick

Ubuntu / Debian

sudo apt install libheif-examples imagemagick

Then download this repository:

git clone https://github.com/iamthe000/HEICmustKoroScript.git
cd HEICmustKoroScript
chmod +x heic_koros.sh

---

🚀 Usage

Basic

./heic_koros.sh photo.heic

→ Creates photo.png.

Output as JPEG (quality 85)

./heic_koros.sh -f jpeg -q 85 photo.heic

Convert entire folder

./heic_koros.sh -r images/

Specify output directory

./heic_koros.sh -r -f png -o converted/ images/

---

🪄 Options

Option	Description
-f FORMAT	Output format: png or jpeg (default: png)
-q QUALITY	JPEG quality (1–100, default: 90)
-r	Recurse into directories
-o DIR	Output directory
-h	Show help message

---

💡 Example

./heic_koros.sh -r -f jpeg -q 80 -o output_dir/ ~/Pictures/

Converts all HEIC files in ~/Pictures/ to JPEG (quality 80), saving them in output_dir.

---

📜 License

MIT License © 2025 iamthe000

---

✨ About the Name

“HEIC Korosu Script” is a playful name — korosu means “to kill” in Japanese, as in “kill the HEIC files.” Don’t worry — it’s a gentle script that just converts them to PNG or JPEG 😄☕