✓ Verified 💻 Development ✓ Enhanced Data

Inkjet

Print text, images, and QR codes to a wireless Bluetooth thermal printer.

Rating: 4.8 (315 reviews)
Downloads: 4,844 downloads
Version: 1.0.0

Overview

Print text, images, and QR codes to a wireless Bluetooth thermal printer.

Complete Documentation

View Source →

Thermal Printer Skill

Print text, images, and QR codes to a small cheap Bluetooth thermal printer like the X6h, GT01, and childrens toy cat printers using the inkjet CLI. Thermal paper is extremely low-cost, enabling high-frequency physical output.

Setup

Preparation: Ensure your printer is turned ON. The printer does NOT need to be paired to the host computer's Bluetooth settings; inkjet connects directly via BLE.

Scan for printers and set default:

bash

inkjet scan

Check current configuration:

bash

inkjet whoami

Print Text

Print strings directly. Supports standard escape sequences like \n for multiline output. Do not use 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. This is the recommended way for agents to output complex receipts or logs without saving temporary files. Do not use emojis.

bash

inkjet print text "# Order 104\n- 1x Coffee\n- 1x Donut" --markdown

Print Files

Output the 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

Generates and prints QR codes. Smartphone scanners (iPhone/Android) can reliably read codes down to --size 75.

bash

inkjet print qr "https://pypi.org/project/inkjet"
inkjet print qr "WiFi:S:NetworkName;P:example123;;" --size 75

Paper Control

bash

inkjet feed 100      # Feed paper forward (steps)

Configuration

Manage settings globally or locally per project. If a .inkjet/ folder exists in the current workspace, it will be prioritized (config setting with --local to create).

bash

inkjet config show                    # Show all settings
inkjet config set printer <UUID>      # Set the default device
inkjet config set energy 12000        # Set local project darkness
inkjet config alias kitchen <UUID>    # Save a friendly name

Default Config Schema

json

{
  "default_printer": "UUID",
  "printers": { "alias": "UUID" },
  "energy": 12000,
  "print_speed": 10,
  "quality": 3,
  "padding_left": 0,
  "padding_top": 10,
  "line_spacing": 8,
  "align": "left",
  "font_size": 18
}

Multi-Printer Orchestration

If the environment (e.g., TOOLS.md) contains multiple printer UUIDs or aliases, target specific hardware using the --address / -a flag. Use -a default to explicitly target the primary configured device.

Orchestration Strategies:

Role-Based Routing: Route content based on hardware role (e.g., Stickers vs Receipts).

inkjet print text "Label" -a stickers

High-Throughput (Load Balancing): Distribute jobs across a farm of printers (Round-Robin) to maximize prints-per-minute.

bash

# Orchestrated Print Examples
inkjet print text "Main Status" -a office
inkjet print text "Order #104" -a kitchen
inkjet print qr "https://pypi.org/project/inkjet" -a default
inkjet print file ./log.txt -a "UUID_EXT_1"

JSON Output (for scripting)

Commands support --json for machine-readable output:

bash

inkjet scan --json
inkjet whoami --json

Best Practices for Worksheets & Handwriting

Thermal paper is narrow and low-cost. To make usable worksheets for children or manual notes:

Size for Visibility: Use ## (H2 headers) for the main content. Standard text is often too small for children to read/write comfortably.
Manual Numbering: Avoid Markdown lists (1. content). They auto-indent and reduce horizontal space. Use ## 1) 5 + 2 = ___ instead.
The "Cheap Paper" Rule: Use triple newlines (\n\n\n) between items. Thermal paper is essentially free; use vertical space to provide actual "writing room."
Horizontal Rules: Use --- at the end of a job to provide a clear tear-off line that doesn't cut off the last problem.

Troubleshooting

If printer not found: ```bash inkjet doctor

Installation

Terminal bash


openclaw install inkjet

Copied!

💻Code Examples

inkjet print text "Big Text" --size 72

inkjet-print-text-big-text---size-72.txt

## Print Markdown

Render high-fidelity formatted content using Markdown syntax. This is the recommended way for agents to output complex receipts or logs without saving temporary files. Do not use emojis.

inkjet print text "# Order 104\n- 1x Coffee\n- 1x Donut" --markdown

inkjet-print-text--order-104n--1x-coffeen--1x-donut---markdown.txt

## Print Files

Output the contents of a local file. Supports plain text (`.txt`) and Markdown (`.md`).

inkjet print image ./logo.jpg --dither

inkjet-print-image-logojpg---dither.txt

## Print QR Codes

Generates and prints QR codes. Smartphone scanners (iPhone/Android) can reliably read codes down to `--size 75`.

inkjet feed 100 # Feed paper forward (steps)

inkjet-feed-100--feed-paper-forward-steps.txt

## Configuration

Manage settings globally or locally per project. If a `.inkjet/` folder exists in the current workspace, it will be prioritized (config setting with --local to create).

}

.txt

## Multi-Printer Orchestration

If the environment (e.g., `TOOLS.md`) contains multiple printer UUIDs or **aliases**, target specific hardware using the `--address` / `-a` flag. Use `-a default` to explicitly target the primary configured device.

### Orchestration Strategies:
1. **Role-Based Routing**: Route content based on hardware role (e.g., Stickers vs Receipts).
   `inkjet print text "Label" -a stickers`
2. **High-Throughput (Load Balancing)**: Distribute jobs across a farm of printers (Round-Robin) to maximize prints-per-minute.

inkjet print file ./log.txt -a "UUID_EXT_1"

inkjet-print-file-logtxt--a-uuidext1.txt

## JSON Output (for scripting)

Commands support `--json` for machine-readable output:

inkjet whoami --json

inkjet-whoami---json.txt

## Best Practices for Worksheets & Handwriting
Thermal paper is narrow and low-cost. To make usable worksheets for children or manual notes:

1. **Size for Visibility:** Use `##` (H2 headers) for the main content. Standard text is often too small for children to read/write comfortably.
2. **Manual Numbering:** Avoid Markdown lists (`1. content`). They auto-indent and reduce horizontal space. Use `## 1) 5 + 2 = ___` instead.
3. **The "Cheap Paper" Rule:** Use triple newlines (`\n\n\n`) between items. Thermal paper is essentially free; use vertical space to provide actual "writing room."
4. **Horizontal Rules:** Use `---` at the end of a job to provide a clear tear-off line that doesn't cut off the last problem.

## Troubleshooting

If printer not found:

example.sh

inkjet print text "Hello, World!"
inkjet print text "Line 1\nLine 2\nLine 3"
inkjet print text "Big Text" --size 72

example.sh

inkjet config show                    # Show all settings
inkjet config set printer <UUID>      # Set the default device
inkjet config set energy 12000        # Set local project darkness
inkjet config alias kitchen <UUID>    # Save a friendly name

example.json

{
  "default_printer": "UUID",
  "printers": { "alias": "UUID" },
  "energy": 12000,
  "print_speed": 10,
  "quality": 3,
  "padding_left": 0,
  "padding_top": 10,
  "line_spacing": 8,
  "align": "left",
  "font_size": 18
}