playbooks

home / skills / openclaw / skills / snapmaker

snapmaker skill

/skills/lucakaufmann/snapmaker

This skill lets you monitor and control Snapmaker U1 printers via Moonraker, displaying status, temperatures, and issuing pause, resume, or cancel.

npx playbooks add skill openclaw/skills --skill snapmaker

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
3.2 KB
---
name: snapmaker
version: 1.0.0
description: Monitor and control Snapmaker 3D printers (U1 with Moonraker/Klipper). Use when checking print status, temperatures, progress, or controlling prints (pause/resume/cancel). Triggers on "printer", "3D print", "Snapmaker", "print status", "nozzle temp", "bed temp".
license: MIT
---

# Snapmaker Printer Control

Control Snapmaker U1 printers via the Moonraker API.

## Configuration

Create a config file at `~/clawd/config/snapmaker.json`:
```json
{
  "ip": "192.168.x.x",
  "port": 80
}
```

Or use environment variables:
```bash
export SNAPMAKER_IP=192.168.x.x
export SNAPMAKER_PORT=80  # optional, defaults to 80
```

**Config search order:**
1. `SNAPMAKER_IP` environment variable (highest priority)
2. `~/clawd/config/snapmaker.json`
3. `~/.config/clawdbot/snapmaker.json`

## Quick Commands

### Check Status
```bash
scripts/snapmaker.py status
```

### Filament Info
```bash
scripts/snapmaker.py filament
```
Shows RFID tag data for each slot: material type, color (hex), temp ranges, and sensor status.

### Monitor Print (Live)
```bash
scripts/snapmaker.py monitor
```

### Print Control
```bash
scripts/snapmaker.py pause
scripts/snapmaker.py resume  
scripts/snapmaker.py cancel
```

### Temperature
```bash
scripts/snapmaker.py temps
```

## API Reference

The U1 uses Moonraker REST API on port 80:

| Endpoint | Description |
|----------|-------------|
| `/server/info` | Server status |
| `/printer/info` | Printer info |
| `/printer/objects/query?heater_bed&extruder&print_stats` | Status |
| `/printer/print/pause` | Pause print |
| `/printer/print/resume` | Resume print |
| `/printer/print/cancel` | Cancel print |

## Status Response Fields

- `print_stats.state`: `standby`, `printing`, `paused`, `complete`, `error`
- `print_stats.filename`: Current file
- `print_stats.print_duration`: Seconds elapsed
- `virtual_sdcard.progress`: 0.0 to 1.0
- `heater_bed.temperature` / `heater_bed.target`: Bed temps
- `extruder.temperature` / `extruder.target`: Nozzle temps

## Filament & Sensor Data

Query filament RFID and sensors:
```
/printer/objects/query?filament_detect&filament_motion_sensor%20e0_filament&filament_motion_sensor%20e1_filament&filament_motion_sensor%20e2_filament&filament_motion_sensor%20e3_filament
```

### filament_detect.info[]

Array of 4 slots with RFID tag data (or defaults if no tag):

| Field | Description |
|-------|-------------|
| `VENDOR` | "Snapmaker" or "NONE" if no RFID |
| `MANUFACTURER` | e.g. "Polymaker" |
| `MAIN_TYPE` | Material: "PLA", "PETG", "ABS", etc. |
| `SUB_TYPE` | Variant: "SnapSpeed", "generic", etc. |
| `RGB_1` | Color as decimal int (convert: `#${(rgb>>16&0xFF).toString(16)}...`) |
| `ARGB_COLOR` | Color with alpha (decimal) |
| `WEIGHT` | Spool weight in grams |
| `HOTEND_MIN_TEMP` / `HOTEND_MAX_TEMP` | Nozzle temp range |
| `BED_TEMP` | Recommended bed temp |
| `OFFICIAL` | true if official Snapmaker filament |

### filament_motion_sensor e{0-3}_filament

| Field | Description |
|-------|-------------|
| `filament_detected` | Boolean - filament present in slot |
| `enabled` | Boolean - sensor active |

**Note:** Slots can have `filament_detected: true` but `VENDOR: NONE` — this means third-party filament without RFID tag.

Overview

This skill monitors and controls Snapmaker U1 3D printers that run Moonraker/Klipper. It provides status, temperature, filament RFID and sensor details, live print monitoring, and basic print controls (pause/resume/cancel). Use it to check progress, verify nozzle/bed temps, or send simple remote commands.

How this skill works

The skill talks to the printer’s Moonraker REST API (default port 80) to query server, printer, heater, extruder, print_stats, and filament objects. It reads fields such as print state, filename, elapsed time, progress, and heater target/actual temps. It can also call Moonraker endpoints to pause, resume, or cancel prints and fetch RFID/sensor filament metadata.

When to use it

  • Check current print state and progress remotely
  • Verify nozzle and bed temperatures during a print
  • Inspect filament RFID metadata and spool weight info
  • Monitor live print progress and elapsed time
  • Pause, resume, or cancel active prints safely

Best practices

  • Provide the printer IP and port via SNAPMAKER_IP / SNAPMAKER_PORT or a ~/clawd/config/snapmaker.json file
  • Prefer environment variables for automation and higher precedence in config resolution
  • Poll status endpoints at modest intervals (e.g., 5–15s) to avoid overloading Moonraker
  • Use filament sensor and RFID data together: sensor indicates presence, RFID gives vendor/material metadata
  • Confirm printer state before issuing control commands (only pause/resume when printing/paused)

Example use cases

  • Automated dashboard that shows nozzle/bed temps and percent complete for remote monitoring
  • Script that pauses the printer when a filament motion sensor reports out-of-filament
  • Tool that logs RFID spool metadata and remaining spool weight for inventory
  • CLI or bot command that returns filename, elapsed print time, and estimated progress
  • Emergency cancel/resume actions triggered from a remote control interface

FAQ

How do I configure the printer address?

Set SNAPMAKER_IP (and optional SNAPMAKER_PORT) as environment variables or create ~/clawd/config/snapmaker.json with ip and port fields.

What print states are reported?

Moonraker print_stats.state values include standby, printing, paused, complete, and error.