KlipperScreen for FLSUN Super Racer

KlipperScreen is a touchscreen GUI that interfaces with Klipper via Moonraker. It can switch between multiple printers to access them from a single location, and it doesn't even need to run on the same host, you can install it on another device and configure the IP address to access the printer.

Documentation

Click here to access the documentation.

About

This version of KlipperScreen is compatible with FLSUN Super Racer, it's optimized for Delta printers.

• Latest build of KlipperScreen
• Improved Z-Offset Calibration menu
• Added support for Endstops Phase Calibration
• Some fixes and adjustments

Klipper Configuration for Super Racer is also available here: Klipper-Flsun-Super-Racer

If you like my work, don't hesitate to support me by paying me a 🍺 or a ☕. Thank you 🙂

Installation

• Make sure previous installation of KlipperScreen is removed (with Kiauh).
• In SSH, enter the following commands (one at a time) to install KlipperScreen:

git clone https://github.com/Guilouz/KlipperScreen-Flsun-Super-Racer.git
sudo mv /home/pi/KlipperScreen-Flsun-Super-Racer /home/pi/KlipperScreen
cd ~/KlipperScreen
./scripts/KlipperScreen-install.sh

Note: Installation may take several minutes.

• Go to your Mainsail Web interface then select the Machine tab.
• Open the moonraker.conf file and modify the [update_manager KlipperScreen] section as follows:

[update_manager KlipperScreen]
type: git_repo
path: ~/KlipperScreen
origin: https://github.com/Guilouz/KlipperScreen-Flsun-Super-Racer.git
virtualenv: ~/.KlipperScreen-env
requirements: scripts/KlipperScreen-requirements.txt
system_dependencies: scripts/system-dependencies.json
managed_services: KlipperScreen

• Once done, click on SAVE & RESTART at the top right to save the file.
• You can now click the refresh button (still in the Machine tab) on the Update Manager tile.
• You will see a new KlipperScreen update appear, if you see a ⚠️DIRTY update, just select Hard Recovery to update.

• Once installed you will have the new version of KlipperScreen and future updates will point directly to my repo like this:

Restoration

• Make sure previous installation of KlipperScreen is removed (with Kiauh).
• In SSH, enter the following commands (one at a time) to install KlipperScreen:

git clone https://github.com/KlipperScreen/KlipperScreen.git
cd ~/KlipperScreen
./scripts/KlipperScreen-install.sh

Note: Installation may take several minutes.

• Go to your Mainsail Web interface then select the Machine tab.
• Open the moonraker.conf file and modify the [update_manager KlipperScreen] section as follows:

[update_manager KlipperScreen]
type: git_repo
path: ~/KlipperScreen
origin: https://github.com/KlipperScreen/KlipperScreen.git
virtualenv: ~/.KlipperScreen-env
requirements: scripts/KlipperScreen-requirements.txt
system_dependencies: scripts/system-dependencies.json
managed_services: KlipperScreen

Notes

My Macros for Super Racer can be found here : macros.cfg

• Multiple Calibrations Menu use the following Macros:

  • Z Offset Calibration function use [gcode_macro Z_OFFSET_CALIBRATION]
  • EndStops Calibration function use [gcode_macro ENDSTOPS_CALIBRATION]
  • Automatic Delta Calibration function use [gcode_macro DELTA_CALIBRATION]
  • Apply a safety Offset function use [gcode_macro SECURITY_OFFSET]
  • Bed Mesh function use [gcode_macro BED_LEVELING]
  • Hotend PID function use [gcode_macro PID_HOTEND]
  • Bed PID function use [gcode_macro PID_BED]

• To use M600 Macro, you need to change [filament_switch_sensor filament_sensor] section in your printer.cfg file like this:

[filament_switch_sensor filament_sensor]
pause_on_runout: True
runout_gcode: M600
...

• To have screen notifications, add this in your printer.cfg file:

[respond]

• To use Endstops Calibrate function, it's needed to have this in your printer.cfg file:

[endstop_phase stepper_a]
endstop_align_zero: false

[endstop_phase stepper_b]
endstop_align_zero: false

[endstop_phase stepper_c]
endstop_align_zero: false

• This version of KlipperScreen save Z-Offset in real time. This is needed:

• Add this in your printer.cfg file:

[save_variables]
filename: ~/printer_data/config/variables.cfg

• And must be used with this Macros:

[gcode_macro SET_GCODE_OFFSET]
description: Saving Z-Offset
rename_existing: _SET_GCODE_OFFSET
gcode:
  {% if printer.save_variables.variables.gcode_offsets %}
  {% set offsets = printer.save_variables.variables.gcode_offsets %}
  {% else %}
  {% set offsets = {'z': None} %}
  {% endif %}
  {% set ns = namespace(offsets={'z': offsets.z}) %}
  _SET_GCODE_OFFSET {% for p in params %}{'%s=%s '% (p, params[p])}{% endfor %}
  {%if 'Z' in params %}{% set null = ns.offsets.update({'z': params.Z}) %}{% endif %}
  {%if 'Z_ADJUST' in params %}
  {%if ns.offsets.z == None %}{% set null = ns.offsets.update({'z': 0}) %}{% endif %}
  {% set null = ns.offsets.update({'z': (ns.offsets.z | float) + (params.Z_ADJUST | float)}) %}
  {% endif %}
  SAVE_VARIABLE VARIABLE=gcode_offsets VALUE="{ns.offsets}"

[delayed_gcode LOAD_GCODE_OFFSETS]
initial_duration: 2
gcode:
  {% if printer.save_variables.variables.gcode_offsets %}
  {% set offsets = printer.save_variables.variables.gcode_offsets %}
  _SET_GCODE_OFFSET {% for axis, offset in offsets.items() if offsets[axis] %}{ "%s=%s " % (axis, offset) }{% endfor %}
  { action_respond_info("Loaded Z-Offset from variables.cfg file: %s" % (offsets)) }
  {% endif %}

• To display printers icons on printer select screen, your printers must be named like that:
  • Flsun V400: FLSUN V400
  • Flsun Super Racer: FLSUN SR
  • Flsun QQS Pro: FLSUN QQSP
  • Flsun Q5: FLSUN Q5

Changelog

• 27/08/2023:

  • klippyGtk: Fixup possible issues with spinner and busy state.
  • macros: Hide load and unload (use them in the extrude panel).
  • macros: Hide macros with rename_existing (equal to Mainsail).
  • menu: Fit 4 rows.
  • Refactor temp updates for devices fix extruder_stepper icon error.
  • Reverted "bed_mesh: load default if no mesh have been loaded".
  • Fixed changes from env to virtualenv.

• 22/08/2023:

  • Temporarily disabled backgrounds for themes to fix issue with buttons staying in busy state.
  • camera: Relative url support.
  • camera: Fixed 'No Xvideo support found' error message.
  • base_panel: Fixed printer select.
  • print and spoolman: Fixed arrows.
  • spoolman: Added extra padding to expanders.
  • PEP E721.
  • Log popup messages for debugging.
  • Updated translations.

• 20/08/2023:

  • Added support for Spoolman.
  • Updated documentation.

• 19/08/2023:

  • Add butttons for vertical scrollbars fixes.
  • bed_level: Fixed center button not reporting rotation and reduce icon size fixes.
  • menu: Rename KS settings to KlipperScreen.
  • Define a minimum python version.
  • job_status: Fixup progress initialization if restarted during print.
  • extrude: Show during printing but disable buttons during printing, this allows disabling and checking the filament sensor.
  • move: Settings button relocation for vertical mode.
  • system and splash: Add ignore inhibitors to reboot and shutdown.
  • Refactor tempstore initialization.
  • base_panel: Improvement.
  • Removes main it makes duplicates of searchs and it's annoying.
  • Use callbacks to disable and enable buttons to improve user feedback.
  • klippygcodes: Simplify and remove some alias that are irrelevant.
  • printer: Save and use available commands.
  • main_menu: Allow closing the keypad with the back button.
  • screen: Reinit if necessary, it does make a noticeable difference in slow hardware.
  • moonraker Compat: create system-dependencies.
  • screen: Preload most used panels.
  • camera: Requirements fix for debian bookworm.
  • camera: Add support for moonraker cameras, deprecates camera_url. This also adds support for flipping and rotation (configured in Moonraker).
  • css: Simplify graph_labels.
  • Updated documentation.

• 04/08/2023:

  • job_status: Fixed remaining times.
  • style: Reduced the opacity of disabled buttons (better feedback).
  • keypad: Fixed calibrate pid not showing sometimes.
  • Updated translations.

• 02/08/2023:

  • fine_tune: Split speed and flow selectors close.

  • Added parameter to labels to silence IDE warnings.

  • Reduced the use of contextlib.

  • screen: removed panel subscription.

  • job_status: Refactor to improve efficiency.

  • job_status: Changed progress percentage to time-based instead of file-based.

  • job_status: Fixed screen overflow on small screens.

  • job_status: Tweaks to the calc of time remaining.

  • screen_panel: format_time round minutes since seconds are only shown with less than a minute.

  • screen: Translate dpms failed and save settings after disabling it.

  • screen: Simplify panel loading.

  • screen: Make show_panel parameters more clear.

  • screen: Changes in printer initialization to prevent loading main to early.

  • Changes in how the config is validated. Now it validates in steps:

    • 1 defaults
    • 2 user settings
    • 3 user includes
    • 4 auto-generated section

    Unknown keys will be removed from the auto-generated section if no other errors are found detect and warn about missing newlines in headers.

  • move: Added a failsafe for velocity.

  • macros: Fixed default parameters.

  • Removed unnecessary params from labels.

  • build(deps): bump websocket-client from 1.6.0 to 1.6.1.

  • Updated translations.

• 29/07/2023 :

  • Avoid re-capitalizing names that already include uppercase letters. This improves the presentation of names like "TMC2209", etc. when the user has manually capitalized the name.
  • Use title case instead of only capitalizing the first character.
  • Updated translations.

• 08/07/2023 :

  • Fixed possible issue with the mesh profile is not complete.
  • Extrude: do not call T0 if there is only one extruder.
  • Extrude: change style to hexpand.
  • Updated translations.
  • Updated documentations.

• 03/07/2023 :

  • Fixed multiple zcalibrate opening.
  • Fixed language not saving.
  • Updated translations.

• 02/07/2023 :

  • Added new settings to add arrows for vertical scrollbars.
  • Bed Mesh: Load default if no mesh have been loaded.
  • Calibrate: Use the new method manual_probe is_active to improve detection of status.
  • Fixes on Main Menu.

• 27/06/2023 :

  • Menus reorganization.
  • Added PID calibrate to the keypad with possibility to select temperature.
  • Removed PID calibrations from Calibrations menu.
  • Fixed selected device in job status menu.
  • Use klipper config values for speed and heights on bed level menu.
  • Updated translations.

• 22/05/2023 : Latest KlipperScreen commits / Added new PID section in Calibrations menu

• 18/05/2023 : Latest KlipperScreen commits / Added support for BigTreeTech Pad7 (theme and touch sound)

• 10/03/2023 : Latest KlipperScreen commits

• 11/02/2023 : Improved menu and Z Calibrate Panel / Latest KlipperScreen commits

• 04/01/2023 : Use now official Z Calibrate

• 13/12/2022 : Latest KlipperScreen commits

• 06/12/2022 : Latest KlipperScreen commits

• 04/12/2022 : Latest KlipperScreen commits

• 03/12/2022 : Latest KlipperScreen commits

• 27/11/2022 : Latest KlipperScreen commits / Improvements

• 24/11/2022 : Latest KlipperScreen commits

• 23/11/2022 : Latest KlipperScreen commits / Fixed Reprint button when print is cancelling

• 21/11/2022 : Latest KlipperScreen commits

• 18/11/2022 : Latest KlipperScreen commits / Added possibility to reset Z-Offset on Z Calibration menu

• 09/11/2022 : Latest KlipperScreen commits

• 04/11/2022 : Latest KlipperScreen commits

• 29/10/2022 : Latest KlipperScreen commits

• 25/10/2022 : Added searching KlipperScreen.conf file in new directories

• 16/10/2022 : Latest KlipperScreen commits

• 08/10/2022 : Fixed heaters not showing their respective power percentages

• 04/10/2022 : Latest KlipperScreen commits

• 23/09/2022 : Added layers on Job Status Screen

• 18/09/2022 : Added support for bed mesh profiles and bed mesh visualization

• 11/09/2022 : Added settings to Show Heater Power

• 10/09/2022 : Some menus now use Macros

• 05/09/2022 : Updated to latest KlipperScreen v0.2.6

• 03/09/2022 : Improvements

• 29/08/2022 : First release