Updating your printer.cfg - OpenNeptune3D/OpenNept4une GitHub Wiki

Upon installing OpenNept4une, you'll receive the most current version of printer.cfg. This is occasionally refreshed with new features and therefore requires periodic updating to get the latest configurations & macros.

User-Calibrated Settings

During the initial setup of OpenNept4une, accessible via this Wiki, you'll conduct several calibrations detailed on the Printer Calibration page. Essential settings such as bed_mesh, z_offset, PID tuning, and input_shaper are automatically saved at the end of your printer.cfg under the SAVE_CONFIG section, which looks like this:

#*# <---------------------- SAVE_CONFIG ---------------------->

These settings are commented out (#) in the main body of the printer.cfg file so Klipper actively uses your SAVE_CONFIG values. This approach ensures your calibrated values are separated and prioritised from the main body of the printer.cfg, a standard practice in Klipper.

Making changes to the printer.cfg

Your Custom Macros:

Insert any new or personal macros into the user_settings.cfg file. This file is specifically intended for your customisations, ensuring they remain separate from the default configuration.

Keeping your Modified Settings:

If you've made changes to the printer.cfg file (Not values within SAVE_CONFIG) and want these changes to persist through future updates, copy the modified sections into user_settings.cfg. Alternatively, you can directly copy the sections you intend to modify from printer.cfg into user_settings.cfg and apply your changes there.

Note: if adjustments are within section headers with square brackets e.g. [probe], you only have to copy the relevant section header & specific lines you wish to change. If you wish to edit a gcode_macro section you must copy the whole macro section over to user_settings.cfg and then make your alterations.

When you place your custom settings/macros in user_settings.cfg, these entries override any matching ones found in printer.cfg, eliminating the need to delete or comment out the original entries in printer.cfg. The system is designed so that user_settings.cfg is not affected by updates to the printer's configuration, ensuring that your customisations and additions remain intact.

The example user_settings.cfg below show how one would make some specific changes (these are random examples not necessarily typical changes).

  • Increasing Microsteps whilst disabling interpolation & stealthChop for X & Y
  • Increasing the machines idle timeout duration
  • Fine-tuning the extruder's rotation distance
  • Removing the beeper tones from print pause & end

How to Update your OpenNept4une printer.cfg

  1. Access your printer via SSH.
  2. Execute the opennept4une command.
  3. Choose 1) Install/Update OpenNept4une printer.cfg to install the latest printer configuration.
  4. You may diff your current config with the latest before upgrading.

The update process automatically creates a backup of your existing printer.cfg as backup-printer.cfg.bak in the same directory, with subsequent backups numbered sequentially. It then integrates your previous SAVE_CONFIG settings into the new printer.cfg file, ensuring your calibrated data is preserved through the update.