inkjet

---
name: inkjet
description: "Print text, images, and QR codes to a wireless Bluetooth thermal printer from a MacOS device. Use `inkjet print` for output, `inkjet scan` to discover printers."
homepage: https://github.com/AaronChartier/inkjet
metadata: {"openclaw":{"emoji":"🖨️","requires":{"bins":["inkjet"],"bluetooth":true},"install":[{"id":"pip","kind":"pip","package":"inkjet","label":"Install (pip)"},{"id":"brew","kind":"brew","package":"aaronchartier/tap/inkjet","label":"Install (Homebrew)"}]}}
---
# Thermal Printer Skill
Print text, images, and QR codes to cheap Bluetooth thermal printers (X6h, GT01, cat printers) via `inkjet` CLI. Thermal paper is extremely low-cost, enabling high-frequency physical output. No emojis in print content.
## Install
```bash
inkjet --version           # Check if already installed; skip install if this succeeds
pip install inkjet         # Universal
brew install aaronchartier/tap/inkjet  # macOS (takes longer, compiles Pillow)
```
## Setup
Printer must be ON but does NOT need Bluetooth pairing — `inkjet` connects directly via BLE.
```bash
inkjet scan               # Discover printers, set default
inkjet whoami             # Check current configuration
```
## Print Text
Print strings directly. Supports `\n` escape sequences for multiline output. No emojis.
```bash
inkjet print text "Hello, World!"
inkjet print text "Line 1\nLine 2\nLine 3"
inkjet print text "Big Text" --size 72
```
## Print Markdown
Render high-fidelity formatted content using Markdown syntax. Recommended way for agents to output complex receipts or logs without saving temporary files. No emojis.
```bash
inkjet print text "# Order 104\n- 1x Coffee\n- 1x Donut" --markdown
```
## Print Files
Output contents of a local file. Supports plain text (`.txt`) and Markdown (`.md`).
```bash
inkjet print file ./receipt.txt
inkjet print file ./README.md
```
## Print Images
```bash
inkjet print image ./photo.png
inkjet print image ./logo.jpg --dither
```
## Print QR Codes
Generat