LogoLogo
MainsailMainsailOSCrowsnest
  • Welcome to Mainsail
  • Setup
    • Installation
      • MainsailOS
      • KIAUH
      • Docker
      • Manual setup
      • my.mainsail.xyz
    • Updates
      • Update Manager
      • Manual Update
    • Configuration
  • overview
    • Features
      • Bed Mesh
      • Console
      • Dashboard Organisation
      • Exclude Objects
      • Hide macros, outputs or fans
      • Localization
      • Macro Management
      • Macro Prompts
      • Presets
      • Print History and Statistics
      • Query devices
      • Built-in Themes
      • Custom Themes
        • Prepare
        • Backgrounds
        • Logos and Icons
        • Custom Navigation
        • Custom CSS
        • Community Themes
      • Thumbnails
      • Webcam
    • Settings
      • General
      • Console
      • Control
      • Dashboard
      • Editor
      • G-Code Viewer
      • Macros
      • Presets
      • Printers
      • UI-Settings
      • Webcams
    • Slicer
      • Cura
      • Ideamaker
      • PrusaSlicer
      • SuperSlicer
    • Quicktips
      • Slicer upload
      • Remote Access
      • Printer power switch
      • Additional Sensors
      • Disable Octoprint LCD menu
      • config.json
  • FAQ
    • Mainsail
    • Klipper warnings
      • Deprecated Values
      • Deprecated Options
      • Runtime Warning
    • Moonraker warnings
      • PolicyKit Permissions
    • Klipper errors
      • MCU Protocol error
    • Mainsail errors
      • Unauthorized
    • Getting Help
      • Discord
      • GitHub Discussions
  • About
    • Data Privacy
    • Sponsors
    • Development
      • Code standards
      • Contribute
      • Environment
      • Localization
    • Credits
  • 🔗Links
    • Github
    • Release Notes
    • Discord
    • Youtube
Powered by GitBook
On this page
  • Since PrusaSlicer v2.7.0
  • Before PrusaSlicer v2.7.0
  • Enable the Label objects setting in your slicer
  • Enable the G-Code preprocessor in Moonraker
  • Enable exclude_object module in Klipper

Was this helpful?

Edit on GitHub
  1. overview
  2. Features

Exclude Objects

Exclude individual objects while a print is in progress.

PreviousDashboard OrganisationNextHide macros, outputs or fans

Last updated 1 year ago

Was this helpful?

This feature was integrated in Klipper v0.10.0-438, Moonraker v0.7.1-445 and Mainsail v2.1.0. Please check your installed versions first and update them if necessary.

In order to use the feature, your slicer must be configured to name the individual objects in the G-Code. The G-Code must be preprocessed either by a post-processing script in the slicer or by Moonraker plus the functionality must be enabled in Klipper. Since PrusaSlicer v2.7.0, you can generate the complete file correctly in the slicer and the Moonraker preprocessor is no longer required.

Please note that only G-Code files that have been prepared accordingly support the feature, it will not work with old, unprocessed files.

Since PrusaSlicer v2.7.0

At first, you have to double-check the G-code flavor in:

Printer Settings > General > Firmware > G-code flavor

Next step, have to change the Label Objects setting to Firmware-specific in:

Print Settings > Output options > Output file > Label objects

Before PrusaSlicer v2.7.0

Enable the Label objects setting in your slicer

In PrusaSlicer or SuperSlicer you have to enable the checkbox in:

Print Settings > Output options > Output file > Label objects

Cura & Ideamaker label objects by default in the G-Code, and they are automatically compatible without any further settings.

Enable the G-Code preprocessor in Moonraker

This step is necessary to convert the previously activated object labels into valid Klipper G-Code. Open your moonraker.conf in Mainsail, add the following setting to your config and restart the Moonraker service:

[file_manager]
enable_object_processing: True

Enable exclude_object module in Klipper

Open your printer.cfg in Mainsail and add the following setting to it:

[exclude_object]

From now on all newly uploaded G-Code files should support this function. A new button in form of a dashed square with an x in the center appears in the status panel.

The button will open a dialog in which you can select each individual object and exclude it from the currently ongoing print.

Only G-Code files prepared this way support excluding objects.

Alternatively it is possible to use an external preprocessor. See for more details.

For more information about the exclude_object module in Klipper see:

preprocess-cancellation
exclude_object
Printer Settings > General > Firmware (since v2.7.0)
Print Settings > Output options > Output file (since v2.7.0)