GRKit

English | 简体中文 | 繁體中文 | 日本語 | 한국어

GRKit adds film looks, XPan and other crops, date stamps, glow, and grain to RICOH GR III, GR IIIx, and GR IV. It runs from the SD card and never writes to the firmware. Take the card out and the camera is back to stock.

Photo: MIKI Yoshihito, CC BY 2.0.

Press the ADJ lever while shooting and pick the sixth item, GRK.

• Film Look: film looks such as Portra 400 and Tri-X 400 with a live preview, plus your own LUTs and Lightroom presets (sources).
• Framing: XPan, 2.35:1, 16:9, 4:3, 5:4, 7:6, or 1:1 photos, or frame lines only.
• Crop: 35, 40, 50, or 70 mm crops (50 to 100 mm on GR IIIx).
• Guides: thirds, center, golden ratio, diagonals, golden spiral, or dynamic symmetry.
• Date Imprint: the date on the photo in classic, GR1s dot-matrix, or GR II style.
• Glow: bloom and film halation around bright lights.
• Border: a thin, wide, or instant-style white or black border around the full photo.
• Grain: film grain in four strengths and four sizes.
• Recipes: save a look with its camera settings as a recipe, or add one from grkit.app, and switch to it in one step or with U1 to U3.

GRKit takes about 8 to 10 seconds to load after power-on, and longer on GR IV or on the first start after an install or update. Until then, the camera uses its own settings. All the settings are in the GRKit section at the end of the Customize tab in MENU. To write your own module, see Writing a module.

Fast start: with the optional fast-boot firmware, the same GRKit package loads soon after power-on. You make it on the Fast start page of grkit.app from the official Ricoh firmware and install it as a firmware update. GRKit itself never writes to the firmware.

GR IV Monochrome has no Film Look. Other models and firmware versions aren't supported. If GRKit doesn't load on a supported camera, see the firmware dump guide.

Pick your camera, modules, and effects on grkit.app, then either:

• Write to the SD card from Chrome or Edge on a computer. The site can also update or uninstall GRKit and add or remove modules and effects.
• Download GRKit.zip and follow the PDF guide inside it (GR III and GR IIIx, GR IV).

The first time only, hold MENU while you turn the camera on. To update from a ZIP, replace the SCRIPT folder on the card. Your settings stay in GRKIT. Formatting the card removes GRKit, so copy GRKIT to a computer first.

If GRK doesn't show up, check the FAQ on grkit.app. If that doesn't help, send GRKIT/REPORT.TXT, GRKIT/BOOT.TXT, and SCRIPT/GRKIT/INSTALL.ERR (if it exists) in a device report.

You need Rust 1.92 or later, Clang and LLD with ARM support, and the official Ricoh firmware file, which this repository doesn't include.

cargo install --path crates/grkit-cli --locked
grkit effects build --source effects --out build/effects
grkit build --target gr3-2.10 --firmware firmware/fwdc239b.bin --out build/runtime
for module in modules/*/; do grkit module build --dir "$module" --out "build/modules/$(basename "$module").GRM"; done
sh .github/scripts/install-guide-tools.sh build/guide-tools
sh .github/scripts/build-guides.sh grkit build/guide-tools build/guides
grkit package --build build/runtime --effects build/effects $(for m in build/modules/*.GRM; do printf -- '--module %s ' "$m"; done) \
  --guide build/guides/gr3/en.pdf --out dist/GRKit.zip
grkit verify dist/GRKit.zip

For other cameras, fewer modules, or other guide languages, see Build packages.

See CONTRIBUTING.md. Device reports are welcome whether GRKit worked or not, especially for firmware that hasn't been tested on a camera yet. Report problems and ask questions through the support form. Suggest features and vote for the ones you want on the feedback board. You can also support the project by buying me a coffee.

• Architecture
• Writing a module and the module reference
• Fast-boot firmware: the script interface for SD scripts
• Release process
• Effects
• Web site

The code is under the MIT License. Each package includes LICENSES.md with the licenses of its files.

• The effects are under CC BY-SA 4.0 or MIT. See effects/NOTICE.md.
• The menu and live view text uses Roboto Condensed under the SIL Open Font License 1.1.
• The effect fitting is ported from gr3-film-mods under the MIT License.

RICOH and GR are trademarks of Ricoh Company, Ltd. Film names are trademarks of their respective owners. GRKit is an independent project and is not affiliated with Ricoh or any film manufacturer.