Plugin: Moonraker

The Moonraker integration consists of two components that together enable full Klipper/Moonraker printer connectivity with FilaMan:

1. FilaMan Moonraker Driver Plugin – installed in FilaMan, provides the printer driver
2. FilaMan Moonraker Component – manually installed in Moonraker, runs on the printer server (e.g. Raspberry Pi); handles extrusion tracking and consumption reporting

Installing the Driver Plugin: → Admin: Plugin Management

Overview

Part 1: FilaMan Moonraker Driver Plugin

The driver plugin is installed in FilaMan and enables communication with the Moonraker server. It forwards spool assignments from FilaMan to the Moonraker endpoint /server/filaman/spool_id.

Configuration

When adding or editing a Moonraker printer, the following configuration fields are available:

Example configuration (JSON):

{
  "moonraker_url": "http://192.168.1.20:7125",
  "api_key": "",
  "mode": "toolhead_only",
  "request_timeout_seconds": 10,
  "slot_count": 1,
  "slot_targets": [
    {
      "slot_index": "0-0",
      "slot_name": "Toolhead 1",
      "slot_kind": "toolhead",
      "assign_gcode": "SET_TRAY_SPOOL TRAY=1 SPOOL={spool_id}"
    }
  ]
}

Modes

Slot Discovery (Auto-Detection)

The plugin automatically detects available slots from the Moonraker printer objects:

• Toolhead slots are discovered from printer objects (extruder, extruder1, ...)
• Tray slots (AFC/MMU) are only shown when Moonraker reports corresponding AFC or MMU objects
• If no tray objects are present, only toolhead slots are displayed
• Manually specifying slot_targets in the configuration overrides auto-discovery

Placeholders for assign_gcode

In tray_macros mode, the assign_gcode field supports the following placeholders:

Part 2: FilaMan Moonraker Component (Manual Installation)

The Moonraker component is a native Moonraker extension that runs on the same server as Moonraker (usually a Raspberry Pi). It handles:

• Consumption tracking – measuring extrusion length from Klipper toolhead updates
• Weight calculation – converting length (mm) to weight (g) using filament metadata
• Consumption reporting – automatically reporting usage to FilaMan (/api/v1/spools/{id}/consumptions)
• Spool tracking – managing the active spool via Moonraker endpoint and remote method

Note: The Moonraker component is optional but recommended. Without it, FilaMan cannot perform automatic consumption tracking for Klipper printers.

Prerequisites

• Moonraker and Klipper are installed and running
• FilaMan is reachable on the local network
• SSH access to the printer server (e.g. Raspberry Pi)

Installation

Step 1: Download the component file

Connect to the printer server via SSH and download the filaman.py file into the Moonraker components directory:

cd ~/moonraker/moonraker/components
wget https://github.com/Fire-Devils/FilaMan-Moonraker-Komponente/raw/main/filaman.py

Alternatively, download the file manually and transfer it via SFTP/SCP.

Step 2: Update the Moonraker configuration

Open moonraker.conf (typically located at ~/printer_data/config/moonraker.conf or ~/klipper_config/moonraker.conf) and add the following section:

[filaman]
server: http://192.168.1.50:8000
api_key: uak.123.xxxxxxxxxxxxxxxxxxxxx
sync_rate: 5
default_density_g_cm3: 1.24
default_diameter_mm: 1.75

Replace http://192.168.1.50:8000 with the actual URL of your FilaMan instance.

Step 3: Restart Moonraker

sudo systemctl restart moonraker

Then check the Moonraker logs for errors:

journalctl -u moonraker -n 50

Configuration Options

HTTP Endpoints

After installation, the component exposes the following endpoints:

Additionally, Spoolman-compatible aliases are always active:

Remote Methods (GCode Macros)

The component registers the following remote methods that can be called from Klipper macros:

• filaman_set_active_spool
• spoolman_set_active_spool (Spoolman-compatible alias)

Setting Up GCode Macros

Add these macros to your printer.cfg or an included configuration file to control the active spool via GCode:

[gcode_macro SET_ACTIVE_SPOOL]
gcode:
  {% if params.ID %}
    {% set id = params.ID|int %}
    {action_call_remote_method("filaman_set_active_spool", spool_id=id)}
  {% else %}
    {action_respond_info("Parameter 'ID' is required")}
  {% endif %}

[gcode_macro CLEAR_ACTIVE_SPOOL]
gcode:
  {action_call_remote_method("filaman_set_active_spool", spool_id=None)}

You can then set the active spool in your print start macro or manually via the console:

SET_ACTIVE_SPOOL ID=42
CLEAR_ACTIVE_SPOOL

How Both Components Work Together

FilaMan              Moonraker Server (Pi)
─────────            ─────────────────────
Driver Plugin  ←──►  Moonraker Component
  │                    │
  │  POST spool_id     │  Extrusion data
  │  (assignment)      │  (consumption report)
  └──────────────────► └──────────────────► FilaMan API

• The Driver Plugin sends spool assignments from FilaMan to Moonraker
• The Moonraker Component tracks extrusion progress and reports consumption directly back to FilaMan

Tip: Both components work independently. You can use the Driver Plugin without the Moonraker Component (assignment only, no consumption tracking), or vice versa.

← Back: FilaManDB Community Database | Next: Installation on Raspberry Pi →