Macro Prompts
It allows macros in Klipper to trigger dialog prompts to interact with the Firmware and will enable the user to choose between options or to close the dialog again in case it's no longer needed.
This feature needs the [respond]
module of Klipper. So please check if this is enabled in your Klipper config.
This feature has been implemented since Mainsail v2.9.0. So, double-check your Mainsail version to be safe to use this feature.
Supported Macro prompt commands:
With these command, you can build your own Macro-Prompt:
// action:prompt_begin <headline>
This is the first command to define a prompt. The <headline>
-Attribute will be the headline of the prompt dialog.
// action:prompt_text <text>
This command is to add a description text in the prompt.
// action:prompt_button <label>|<gcode?>|<color?>
With this command, you can add a button in the prompt.
<label>
: Is the text inside of the button<gcode?>
: This attribute is optional to add a different G-Code to this button. (Default is the label text)<color?>
: This attribute is optional and will change the color of the button. Possible options areprimary
,secondary
,info
,warning
,error
. (Default is dark gray)
// action:prompt_button_group_start
With this command, you can start a "button group". This will allow you to display multiple buttons in the same row.
// action:prompt_button_group_end
With this command, you can close the current "button group"
// action:prompt_footer_button <label>|<gcode?>|<color?>
With this command, you can add a button in the footer of the prompt.
<label>
: Is the text inside of the button<gcode?>
: This attribute is optional to add a different G-Code to this button. (Default is the label text)<color?>
: This attribute is optional and will change the color of the button. Possible options areprimary
,secondary
,info
,warning
,error
. (Default is white)
// action:prompt_show
With this command, the prompt dialog will be displayed
// action:prompt_end
This command will close/hide the prompt dialog.
Examples
Here some examples of Macro-Prompts
Prompt with multiple Button-Groups
Simple question prompt
Last updated