{"id":50472507,"url":"https://github.com/hannasdev/n8n-nodes-bambulab","last_synced_at":"2026-06-01T11:04:18.643Z","repository":{"id":347303469,"uuid":"1193526283","full_name":"hannasdev/n8n-nodes-bambulab","owner":"hannasdev","description":"Trying out n8n automation","archived":false,"fork":false,"pushed_at":"2026-03-27T15:27:11.000Z","size":680,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-27T22:18:37.094Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hannasdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-27T10:16:38.000Z","updated_at":"2026-03-27T15:27:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hannasdev/n8n-nodes-bambulab","commit_stats":null,"previous_names":["hannasdev/n8n-custom"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/hannasdev/n8n-nodes-bambulab","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannasdev%2Fn8n-nodes-bambulab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannasdev%2Fn8n-nodes-bambulab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannasdev%2Fn8n-nodes-bambulab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannasdev%2Fn8n-nodes-bambulab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hannasdev","download_url":"https://codeload.github.com/hannasdev/n8n-nodes-bambulab/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannasdev%2Fn8n-nodes-bambulab/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33771642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-01T11:04:18.568Z","updated_at":"2026-06-01T11:04:18.624Z","avatar_url":"https://github.com/hannasdev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# n8n-nodes-bambulab\n\nThis is an n8n community node package for controlling and monitoring Bambu Lab printers over the local network.\n\nBambu Lab is a 3D printer platform. This package communicates with the printer directly via local MQTT (no Bambu Cloud required).\n\n[Installation](#installation)\n[Operations](#operations)\n[Credentials](#credentials)\n[Compatibility](#compatibility)\n[Usage](#usage)\n[Resources](#resources)\n\n## Installation\n\nFollow the [n8n community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) and search for `@hanna84/n8n-nodes-bambulab`.\n\nFor local development with the included Docker setup:\n\n```bash\nnpm install\nnpm run build\ndocker compose up -d\n\n# After code changes:\nnpm run build\ndocker compose restart n8n\n```\n\nn8n is available at http://localhost:5678.\n\n## Operations\n\n### Node: Bambu Lab Printer\n\nAn action node for on-demand operations.\n\n| Operation  | Description                                 |\n| ---------- | ------------------------------------------- |\n| Get Status | Request a full status push from the printer |\n\n**Response mode** (Get Status):\n\n- **Summary** — Normalized status object with named fields (temperatures, progress, state, etc.)\n- **Raw** — Full raw MQTT payload from the printer\n\n### Node: Bambu Lab Printer Trigger\n\nA trigger node for event-driven workflows. Maintains a persistent MQTT connection and polls the printer on a configurable interval.\n\n| Parameter               | Description                                                                  |\n| ----------------------- | ---------------------------------------------------------------------------- |\n| Poll Interval (seconds) | How often to request fresh status from the printer (minimum 5s, default 30s) |\n| Response Mode           | **Summary** — normalized fields. **Raw** — full MQTT payload                 |\n| Filter Mode             | Controls when events are emitted (see below)                                 |\n\n**Filter modes:**\n\n| Mode                             | Behaviour                                                                                         |\n| -------------------------------- | ------------------------------------------------------------------------------------------------- |\n| **Any Field Change** _(default)_ | Emits a full snapshot on startup, then fires again whenever a watched field crosses its threshold |\n| **Printer State Only**           | Fires only when `gcode_state` changes (e.g. `IDLE → RUNNING → FINISH`)                            |\n| **Every Message**                | Fires on every MQTT message received — use with care                                              |\n\n**Any Field Change options** (shown when that mode is selected):\n\n| Parameter                  | Default                                     | Description                                                                                 |\n| -------------------------- | ------------------------------------------- | ------------------------------------------------------------------------------------------- |\n| Trigger On Fields          | State, Stage, Layer, Progress, Temps, Error | Checklist of which fields can trigger an event. All fields appear in the output regardless. |\n| Layer Change Threshold     | 1                                           | Minimum layers between events                                                               |\n| Progress Threshold (%)     | 5                                           | Minimum % progress change between events                                                    |\n| Temperature Threshold (°C) | 2                                           | Minimum °C change for actual temps (nozzle, bed, chamber)                                   |\n| Target Temp Threshold (°C) | 1                                           | Minimum °C change for target temperatures                                                   |\n\n**Output fields** (in Summary mode) include: `state`, `stage`, `progress_pct`, `current_layer`, `total_layers`, `nozzle_temp_c`, `bed_temp_c`, `nozzle_target_c`, `bed_target_c`, `chamber_temp_c`, `task_name`, `error_code`, `speed_level`, `chamber_light`, `wifi_signal`, `received_at`, and more.\n\nIn **Any Field Change** mode the output also includes a `triggered_by` object showing which fields changed and their before/after values — useful for debugging unexpected events:\n\n```json\n\"triggered_by\": {\n  \"current_layer\": { \"from\": 20, \"to\": 25 },\n  \"progress_pct\": { \"from\": 23, \"to\": 28 }\n}\n```\n\n## Credentials\n\nCredential type: **Bambu Lab (Local Network)**\n\n| Field                 | Description                                        |\n| --------------------- | -------------------------------------------------- |\n| Printer IP Address    | Local IP of the printer                            |\n| Printer Serial Number | Uppercase alphanumeric serial (e.g. `01P00C5A...`) |\n| Access Code           | 8-character access code                            |\n\nWhere to find these on the printer touchscreen:\n\n- **Settings \u003e Network / WLAN** — IP address and Access Code\n- **Settings \u003e Device** — Serial number\n\n**Security notes:**\n\n- Credentials are stored encrypted by n8n and never written into workflow JSON as plaintext.\n- MQTT traffic is TLS-encrypted on port 8883.\n- Certificate verification is disabled for local printer TLS (Bambu printers use a private CA).\n- Do not expose printer network endpoints to the public internet.\n\n## Compatibility\n\n- Minimum tested n8n version: **2.13.4**\n- Tested on: Docker image `n8nio/n8n:2.13.4`\n- Tested printers: Bambu Lab X1C, P1S (reports from community welcome)\n\nKnown behavior:\n\n- Imported workflows require credentials to be re-selected once in the UI to bind local credential IDs.\n- The Bambu MQTT broker is point-to-point — report messages are only delivered to the requesting client, not broadcast. This is why the trigger node sends its own PUSH_ALL request rather than passively subscribing.\n- Bambu printers allow only one MQTT client at a time. If another device connects to the printer while the trigger node is running, the node will be disconnected. It reconnects automatically within a few seconds and resumes polling, but any events that occurred during the reconnect window will be missed.\n\n## Usage\n\n### Example: Print complete notification\n\n1. Add a **Bambu Lab Printer Trigger** node\n2. Set **Filter Mode** to **Printer State Only**\n3. Connect an **IF** node: condition `state` equals `FINISH`\n4. Connect a **Telegram** (or other) node to send a notification\n\n### Example: Layer progress updates\n\n1. Add a **Bambu Lab Printer Trigger** node\n2. Leave **Filter Mode** as **Any Field Change**\n3. Set **Layer Change Threshold** to `10` (fires every 10 layers)\n4. Uncheck all **Trigger On Fields** except **Current Layer**\n5. Use `current_layer` and `total_layers` in your downstream nodes\n\n### Example: Debugging unexpected events\n\nIf the trigger fires more often than expected, check the `triggered_by` field in the output — it shows exactly which field crossed its threshold (e.g. `{ \"progress_pct\": { \"from\": 23, \"to\": 28 } }`). Uncheck that field in **Trigger On Fields** or raise its threshold.\n\n### Included workflow templates\n\n- `workflows/bambulab-showcase.workflow.json` — manual status check and raw command example\n\nImport:\n\n```bash\ndocker compose exec n8n n8n import:workflow \\\n  --input=/custom-extensions/my-custom-node/workflows/bambulab-showcase.workflow.json\n```\n\nAfter importing, open the workflow in n8n and re-select your **Bambu Lab Local** credential on each node.\n\n## Resources\n\n- [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)\n- [Bambu Lab](https://bambulab.com)\n- [ha-bambulab](https://github.com/greghesp/ha-bambulab) — acknowledged reference for MQTT topic/payload structure\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for the full release history.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhannasdev%2Fn8n-nodes-bambulab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhannasdev%2Fn8n-nodes-bambulab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhannasdev%2Fn8n-nodes-bambulab/lists"}