Open-source CLI and native macOS app for printing to Fujifilm Instax Link printers via Bluetooth Low Energy. Supports the Instax Mini Link, Square Link, and Wide Link.
The Instax Link BLE protocol was reverse-engineered by the open-source community (javl/InstaxBLE, linssenste/instax-link-web). InstantLink provides a clean Rust implementation.
| Crate | Description |
|---|---|
| instantlink-core | Core library — BLE protocol, image processing, device communication |
| instantlink (CLI) | Command-line tool to scan, query, and print |
| instantlink-ffi | C FFI bindings for building native GUIs (Swift, etc.) |
Pre-built releases will be available on the Releases page once tagged.
Build from source:
git clone https://github.com/wu-hongjun/InstantLink.git
cd InstantLink
cargo build --workspace --release
# Install the CLI
cargo install --path crates/instantlink-cli# Scan for nearby printers
instantlink scan
# Check printer status
instantlink status
# Print an image
instantlink print photo.jpg
# Print with specific fit mode and quality
instantlink print photo.jpg --fit contain --quality 90
# Print with natural color mode (classic film look)
instantlink print photo.jpg --color-mode natural
# Control the LED
instantlink led set "#FF6600" --pattern breathe
instantlink led offAll commands support --json for machine-readable output.
| Model | Resolution | Film Type |
|---|---|---|
| Instax Mini Link | 600x800 | Instax Mini |
| Instax Square Link | 800x800 | Instax Square |
| Instax Wide Link | 1260x840 | Instax Wide |
The printer model is auto-detected after connecting.
- Print any image (JPEG, PNG, etc.) to Instax Link printers via BLE
- Auto-resize with crop, contain, or stretch fit modes
- Rich and Natural color modes (vivid vs classic film look)
- Automatic JPEG quality reduction to fit printer limits (105KB)
- Battery level, film count, charging state, and print history queries
- LED color control with solid, blink, and breathe patterns
- BLE scanner to discover nearby printers
- JSON output mode for integration with other tools
- Native macOS app with:
- Menu bar interface with drag-and-drop printing
- Built-in image editor with crop, rotate, overlays, and queue-aware defaults
- Camera capture mode with self-timer (2s / 10s countdown)
- Film orientation toggle (portrait/landscape) with print-time rotation
- Film border preview showing the physical Instax film shape
- Multi-printer management with saved profiles
- Auto-update via GitHub releases
- Localized in 12 languages
- C FFI (19 functions) for building native UIs
InstantLink/
├── Cargo.toml # Workspace root
├── mkdocs.yml # Documentation config
├── docs/ # MkDocs source
├── crates/
│ ├── instantlink-core/ # Core library
│ ├── instantlink-cli/ # CLI binary
│ └── instantlink-ffi/ # C FFI
└── macos/ # Native macOS app (SwiftUI)
└── InstantLink/
The macOS app is a native SwiftUI application with menu bar integration. It loads the Rust core library via FFI (dlopen/dlsym) for direct BLE communication. The bundled CLI remains in the app for lightweight metadata such as version reporting.
Features include drag-and-drop image printing, a built-in image editor, overlays, camera capture with self-timer, film orientation control, film border preview, printer profile management, and auto-updates.
# Build the app bundle
bash scripts/build-app.sh 0.1.3Full docs are available at wu-hongjun.github.io/InstantLink.
MIT