OctoKlipper 0.4

[thelastWallE]

This release is a major update that brings OctoKlipper up to date with the newer OctoPrint versions (while staying backward compatible with 1.11.x), adds a brand-new Monaco-based config editor with a built-in syntax linter, a live klippy.log tail, and significantly improves backup/restore, sudo handling, and the settings UI.

✨ New

• Monaco editor — the config editor has been migrated from Ace to Monaco: better rendering, smoother scrolling, and a proper Monokai theme.
• Syntax linter (squiggle lines) — errors are underlined directly in the editor:
  • Squiggles appear automatically as you type (debounced, no popups).
  • The check also runs when the editor opens.
  • The manual Check Syntax button still shows the full error message.
• Live klippy.log tail — a new Klippy Log tab on the main OctoKlipper tab tails klippy.log in real time, so you can watch for print stalls, retransmits, and other diagnostics without opening an SSH session. It auto-scrolls, has a Pause/Start toggle, and shows which file the backend is loading.
• Log path check in settings — the Klipper Log File setting now has a Check path button that resolves the entered directory on the server and shows whether klippy.log exists there, so a wrong path is immediately obvious.
• Better config backups — backups are now kept in an archive/ folder (previous versions) plus a current/ duplicate, so OctoPrint's own backup always holds the latest config state.
• Backup all configs — a button that copies every config file into the plugin data folder so OctoPrint's own backup holds all of them, not only the ones saved through the plugin. This also runs automatically right before a backup is created.
• Restore servicefile backups — servicefile backups can be restored and deployed to the real path (/etc/default/klipper) via sudo. If passwordless sudo isn't configured, you'll be asked for the sudo password.
• Backup type tags — the backup list now shows whether an entry is a Config or a Servicefile, and restore handles each type correctly.
• Sudo password safety check — before a sudo password is sent, the plugin checks the connection: HTTPS and localhost are fine, anything else asks for your confirmation first.
• Klipper updater — the plugin now fetches the installed and available Klipper versions and gives clear user feedback during update checks, with improved button state management.
• Service restart command — a command to restart the Klipper service directly from the plugin.
• Open last config in editor — an option to open the last edited config directly in the editor.
• Colored short status — the sidebar short status now uses colors for better readability.
• Config versioning plan — a design document for keeping the last 5 versions of every config plus a revert button (coming in a follow-up).

🎨 UI improvements

• Macros settings reworked — the macro list is now a proper table with an Add Macro footer row, a live button preview that shows the macro name as you type, and a style selector that clears the custom color. The example command box is pinned to the bottom of the tab.
• Small dialogs fixed — the assisted bed leveling, coordinate offset, macro parameter, and PID tuning dialogs no longer clip text over button/input borders.
• Fixes — pressing Enter in an input no longer triggers unrelated buttons, the Klipper Tab / Sidebar checkboxes are aligned with their labels, and the copy-to-clipboard icon no longer overlaps the example command text.
• Syntax highlighting — improved highlighting for multiple pins on one line, more Jinja syntax, and a fix for config lines containing =.
• Console messages colorized — log output in the console is now colorized for easier reading.
• Font size preference — the editor font size is now remembered in localStorage.
• Copy button — the copy-to-clipboard button is hidden on plain HTTP connections for safety.

🐛 Fixes

• Config editor fixes — "Reload from file" and backup preview now load the actual content correctly.
• Toast/popup fixes — error notifications now display their message properly.
• Backup/restore — saving and restoring backups no longer fail on paths with trailing separators.
• Additional SAVE_CONFIG check — an extra check before saving the config to avoid accidental overwrites.

🔧 Compatibility & platform fixes

This release reworks the plugin for the newer OctoPrint versions (while staying backward compatible with 1.11.x) and fixes several Windows-specific issues that surfaced in that process:

• OctoPrint compatibility — updated blueprint protection, permissions, and internal APIs for the newer OctoPrint versions.
• Windows path handling — fixed path-separator handling when saving configs in subfolders or the baseconfig, and when restoring backups.
• API documentation — docs/api.md rewritten to document the current routes, methods, request/response formats, and the new backup paths.

🛠 Developer tooling

• Deploy script — a PowerShell script (deploy/deployOctoKlipper.ps1) that builds the zip, uploads it to the Raspberry Pi via SCP, installs it into the OctoPrint venv, and optionally restarts OctoPrint. Supports OpenSSH and PuTTY. It falls back to a non-editable zip install for OctoPrint 1.11.x (editable installs crash there with modern setuptools/pip).
• Zip script rewritten — the packaging script was rewritten from VBScript to PowerShell (.NET System.IO.Compression), fixing unreliable COM-based zipping.
• Tests — a pytest suite covering the config tools, log analyzer, migration, extra utilities, and servicefile modules.

📝 Notes

• Compatible with OctoPrint 1.11.x and the upcoming OctoPrint 2.0.
• Python 3.10+.
• German translations updated.

Full Changelog: 0.3.9.5...v0.4

---

This discussion was created from the release OctoKlipper 0.4.

[HalfricanFPV]

I updated to the latest version while setting up my printer, and now I am unsure how to access my macros file in the Editor. I used to be able to go under the wrench and find the file in the previous version, but I'm not sure how to navigate to edit the macros file now. Saw in a screenshot that there is a button for Klipper Configuration, but that doesn't show up for me. Also had an issue with saving changes to the printer config file. Saved and rebooted; it showed the changes were saved, but apparently they never took effect because I still got the move out of range error. Went in through SSH and those saved changes from the browser did not carry over. I updated through SSH and no longer have the move out of range errors anymore.

[thelastWallE]

make sure you have the correct path to your configs in the settings. I will update the screenshots tomorrow and test the paths again.
Are you on unix(raspberry etc)? Where is your macros config located and where your printer.cfg?