grsync-tui
A fast terminal user-interface for transferring photos from Ricoh GR cameras to your computer via WiFi or USB.

Features
- Browse and select photos from your camera to download
- Supports both WiFi and USB connections
- Preview photos in terminal
- Cross-platform (macOS, Linux, Windows, Termux, etc.)
- Won't download photos that already exist in the download directory
Installation
Install with Go:
go install github.com/tonytwostep/grsync-tui@latest
Or build manually:
git clone https://github.com/tonytwostep/grsync-tui.git
cd grsync-tui
go build -o grsync-tui
./grsync-tui
Configuration
On first run, a config file is automatically created at ~/.config/grsync-tui.json
with some safe defaults.
You can edit this file to set:
connection_method
: "usb"
or "wifi"
download_dir
: Directory where downloaded photos are saved
usb.camera_dir
: Path to the mounted camera directory (for USB mode)
Usage
Run grsync-tui
in your terminal.
Controls / Hotkeys
Use ? / h
to view the applications help menu.
Here is the list as a Markdown table:
Key |
Action |
Up / k |
Move up one item |
Down / j |
Move down one item |
Shift+Up / K |
Expand selection up |
Shift+Down / J |
Expand selection down |
Space |
Toggle selection of current item |
Ctrl+A |
Select all items |
Ctrl+D |
Deselect all items |
d |
Download selected photos |
p |
Show image preview (ascii) |
PgUp / PgDn |
Scroll log up or down |
Home / End |
Scroll photo list to beginning or end |
h / ? |
Show this help |
Ctrl+Q |
Quit the application |
Requirements
- Go 1.24.3
- For WiFi: The device must be connected to the camera's network
- For USB: Camera must be mounted