A node.js library for connecting to and receiving data from Bambu Lab printers through their MQTT servers.
npm install bambu-node> [!CAUTION]
> 🚧 This library is still in the making. PRs and other feature requests are welcome.
A node.js library for connecting to and receiving data from Bambu Lab printers through
their MQTT servers.
- Every command & response field is documented & typed.
- Easily (and safely\*) construct commands & manage responses.
- Full async support! client#executeCommand waits until the command completion is
verified by the printer.
Make sure you have the following installed:
- Node.js
- NPM
- TypeScript
> [!CAUTION]
> TypeScript is highly recommended for this package due to the type safety it provides.
> This is especially important in use cases like this project where the library
> communicates with external hardware which can very well come with property damage. And
> even with TypeScript, I am not liable for any such damages as stated in the
> license.
``bash`
npm install bambu-node
`typescript
import { BambuClient, Fan, UpdateFanCommand } from "bambu-node"
// define a printer connection
const client = new BambuClient({
host: "your_printers_ip",
accessToken: "your_printers_access_token",
serialNumber: "your_printers_sn",
})
// more about the available events below
client.on("message", (topic, key, data) => {
console.log(New ${key} message!, data)
})
client.on("printer:statusUpdate", (oldStatus, newStatus) => {
console.log(The printer's status has changed from ${oldStatus} to ${newStatus}!)
})
// connect to the printer
await client.connect()
// update the speed of the auxiliary fan to 100%
await client.executeCommand(new UpdateFanCommand({ fan: Fan.AUXILIARY_FAN, speed: 100 }))
// we don't want to do anything else => we close the connection
// (can be kept open indefinitely if needed)
await client.disconnect()
`
#### Legend
Unnamed things inside classes: Other classes that extend that class.
Every method, command and response is documented in JSDoc, so only events & utility
classes are documented here.
- Bambu Node
- Class: BambuClient
- Method: BambuClient.connect()
- Method:
- Method:
- Method:
- Event:
- Event:
- Event:
- Event:
- Event:
- Event:
- Event:
- Event:
- Event:
- Event:
- Event:
- Event:
- Class:
- Method:
- Getter:
- Class:
- Class:
-
-
-
-
-
-
-
-
-
- _Command Responses_
- info
- Class:
-
- mcPrint
- Class:
-
- print
- Class:
-
-
-
-
-
-
-
-
-
-
Responsible for managing the connection and messages to/from the printer.
#### Events
##### rawMessage
Triggered whenever a new message is received from the MQTT broker.
#### message
Triggered whenever a new known message is received from the MQTT broker. It's
already parsed and sent using its type.
#### client:connect
Triggered whenever the client connects to the printer. This will also trigger on a
reconnect.
#### client:disconnect
Triggered whenever the client disconnects from the printer. This can be on purpose using
the client#disconnect method or when the printer itself goes offline.
#### client:error
Triggered whenever the internal MQTT client encounters an error.
Examples include:
- Unresolvable host provided
- Incorrect credentials provided
- Unexpected responses
#### printer:dataUpdate
Triggered whenever new data is received from the printer and is merged into the data class
field.
#### printer:statusUpdate
Triggered whenever the printer's status changes to a new status.
#### job:update
Triggered whenever the current Job's data gets updated.
#### job:start
Triggered whenever a new printing job starts.
#### job:pause
Triggered whenever the current print job is paused.
#### job:offlineRecovery
Triggered whenever the current print job was recovered after the printer came back online
from an offline state.
#### job:unpause
Triggered whenever the current print job is resumed.
#### job:finish
Triggered whenever the current print job finishes.
Possible reasons:
- SUCCESS: Triggered whenever the current print job finishes without errors.FAILED
- : Triggered whenever the current print job finishes without errors.UNEXPECTED
- : Triggered whenever the current print job finishes unexpectedly. This is
only included as a proof of concept and is 99% bound to never happen.
Responsible for managing the data about the current print job. It collects historical
data, error codes, etc. It is included in every event starting with job:`.
Pull requests are welcome. For major changes, please open an issue first to discuss what
you would like to change.