v0.1.15

README_ru.md
README_en.md

It is MANDATORY to read the attached README before use. Compliance with this instruction is strictly required.

DISCLAIMER

This software is provided "as is" without warranties of any kind. The developer shall not be liable for any damages, data loss, or financial losses resulting from the use or inability to use this program. Use at your own risk.

v0.1.12

Fix static linking: add zlib for Windows and pass static archive path…

v0.1.5

---

💻 Pre-compiled Binaries Usage Guide

This release contains pre-compiled standalone binaries for Windows, Linux, and macOS (Apple Silicon). You do not need a Go environment to run them.

📋 Quick Command Rules:

1. The input .RAF file path must ALWAYS be passed as the very first argument.
2. Output folder: If you pass a valid directory path as the absolute last argument, all results will be saved there. If omitted, they will be saved right next to the source .RAF file.

• 🟢 STABLE FLAGS (Ready to use): -exr, -tif, -preview, and -light <float> (default 3.5).
• 🔴 EXPERIMENTAL FLAGS (Do not use yet): -mosaic, -dng, and -recovery (currently unstable/in development).

---

🐧 1. Linux Setup & Usage

Binary name: rafparser-linux

Open your terminal in the directory where the binary is downloaded and grant execution permissions:

chmod +x rafparser-linux

Examples:

# Basic export to OpenEXR and TIFF next to the source file:
./rafparser-linux /path/to/photo.RAF -exr -tif

# Extract preview and EXR with custom brightness into an output folder:
./rafparser-linux /path/to/photo.RAF -exr -preview -light 4.0 /path/to/output_dir

---

🪟 2. Windows Setup & Usage

Binary name: rafparser.exe

Run the binary using PowerShell or standard Command Prompt (cmd).

Examples:

# Basic export to OpenEXR next to the source file (PowerShell):
.\rafparser.exe C:\Photos\photo.RAF -exr

# Extract preview and TIFF into a specific custom directory (cmd):
rafparser.exe C:\Photos\photo.RAF -tif -preview D:\Projects\output

---

🍏 3. macOS Setup & Usage (Apple Silicon M1/M2/M3)

Binary name: rafparser-mac

Open your Terminal in the directory with the downloaded binary and grant execution permissions:

chmod +x rafparser-mac

(Note: Since this is an unsigned community binary, macOS gatekeeper might block it on the first launch. Go to System Settings ➔ Privacy & Security and click "Allow Anyway" if prompted).

Examples:

# Quick embedded high-quality JPEG preview extraction:
./rafparser-mac /Users/name/Pictures/photo.RAF -preview

# Generate EXR and TIFF simultaneously into the current active directory:
./rafparser-mac /Users/name/Pictures/photo.RAF -exr -tif -light 3.8 .

DISCLAIMER

This software is provided "as is" without warranties of any kind. The developer shall not be liable for any damages, data loss, or financial losses resulting from the use or inability to use this program. Use at your own risk.

---

README_en.md
README_ru.md

v0.1.3

Fix setup-go action name and download strategy

v0.1.2

Add .github dir

v0.1.1

Create bins dir

v0.1.0

Release v0.1.0 — Initial Alpha Streamlining

We are excited to announce the first tagged release of rafparser (v0.1.0). This initial release establishes a high-performance foundation for parsing and converting Fujifilm RAW (.RAF) files using Go and CGO bindings to LibRaw. Designed specifically for advanced photography pipelines, the utility focuses on delivering raw, unadulterated color data directly from the camera sensor by eliminating traditional interpolation and demosaicing steps.

The core highlight of this release is the stable implementation of physical 2x2 pixel hardware binning combined with a production-ready export to the professional HDR OpenEXR (.exr) format. By utilizing 16-bit floating-point precision and lossless PIZ compression, the utility ensures that extreme highlights are never artificially clipped on export, allowing for complete, elastic exposure adjustments in post-processing tools like Darktable or GIMP. Additionally, a robust, cross-platform CLI engine has been deployed, making the parser fully compatible with custom IDE run configurations and path structures across Linux, macOS, and Windows.

Please note that several features—including Linear DNG packaging, technical mosaic TIFF extraction, and dual-pass highlight recovery—are currently marked as highly experimental and unstable. They are included in this alpha build purely for code reference and architectural prototyping as we actively prepare the pipeline for future updates.