ahonn / grkit

# GRKit
English | 简体中文 | 繁體中文 | 日本語
GRKit adds film looks and shooting tools to RICOH GR cameras. It loads from the SD card and does not write the camera firmware.
Photo: Snow in Akihabara by nagi usano, CC BY 2.0.
## Features
GRKit adds a sixth entry, GRK, to the ADJ menu. It has five modules:
- **Image Control**: 16 film looks, such as Portra 400, Velvia 100, and Tri-X 400. The viewfinder previews the look.
- **Framing**: XPan (65:24), 16:9, or 4:3 photos. The viewfinder dims the area outside the photo.
- **Guides**: thirds, center, golden ratio, or diagonal lines.
- **Date Stamp**: an orange date on the photo, like a film camera's data back.
- **Grain**: film grain on the photo, in three strengths.
The last row shows the GRKit version.
You select the modules when you make a package. The menu shows only those modules.
## Supported cameras
| Camera | Firmware | Status |
| --- | --- | --- |
| RICOH GR III | 2.10 | Tested on a camera |
| RICOH GR III HDF | 2.10 | Supported. It runs the same firmware and runtime as GR III. |
| RICOH GR IIIx | 1.60 | Supported. It runs the same runtime as GR III, which has been tested on a camera. |
| RICOH GR IIIx HDF | 1.60 | Supported. It runs the same firmware and runtime as GR IIIx. |
| RICOH GR IV | 1.11 | Tested on a camera. Framing offers only XPan. |
| RICOH GR IV HDF | 1.11 | Supported. It runs the same firmware and runtime as GR IV. Framing offers only XPan. |
Each HDF model runs the firmware of its base camera and uses the same package. Other models and firmware versions are not supported. To see the firmware version, open the camera menu.
> [!WARNING]
> GRKit is experimental. Use it at your own risk.
> GRKit changes the camera memory only until the camera turns off. The installation turns on the camera's SD script setting, and this setting stays on until you turn it off.
> If GRKit fails, the camera can stop during startup. Read the recovery guide before you install GRKit.
## Install
To make a package, go to grkit.app. Select the camera, the modules, and the effects, then download `GRKit.zip`.
Each package contains the installation guide for its camera as a PDF, in the language that you select. The recovery guide is at its end. The sources are:
- GR III, GR IIIx, and their HDF models
- GR IV and GR IV HDF
To remove GRKit, turn the camera off and delete the `SCRIPT` folder from the card.
To turn the SD script setting off, use the files that grkit.app gives below the installation steps. The installation guide gives the steps.
## Build from source
You need Rust 1.92 or later, Clang and LLD with ARM support, and the official firmware file from Ricoh. The repository does not contain firmware.
 [code] 
- Guides: `install-guide-tools.sh` downloads Typst and the Noto Sans SC, TC, and JP fonts and checks their SHA-256, on Linux x86_64 or macOS arm64. `build-guides.sh` writes `build/guides/ / .pdf`.
- GR IIIx: package with `--camera gr3x` and `--guide build/guides/gr3x/en.pdf`. The runtime is the same as for GR I