OctoprintKlipperPlugin/README.md

76 lines
2.7 KiB
Markdown
Raw Normal View History

## Fork information:
2019-02-14 05:28:27 +03:00
- This is forked from [the original](https://github.com/mmone/OctoprintKlipperPlugin) version 0.2.5
- The current version is 0.2.5-JEL-0.1 and includes modified versions of:
- klipper.js
- klipper_param_macro.js
- klipper_leveling.js
- Changes made result in multiple GCode commands being sent to OctoPrint.control.sendGcode as an array of strings instead of separate strings or as strings with line breaks or other formatting. This results in the commands being received in the intended order and interpreted correctly.
## Fork Installation Information:
- Uninstall any other versions of the plugin using Plugin Manager or other means, as necessary.
- Install this version by using Plugin Manager's "From Url" option and entering this URL:
`https://github.com/jameseleach/OctoprintKlipperPlugin/archive/JEL-0.1.zip`
2019-02-14 05:28:27 +03:00
Original contents follow...
# OctoPrint Klipper Plugin
2018-01-23 17:01:58 +03:00
This plugin assists in managing and monitoring the [Klipper](https://github.com/KevinOConnor/klipper) 3D printer firmware.
2019-02-14 05:28:27 +03:00
## Features
2018-01-24 19:30:01 +03:00
- Simplified connection dialog.
- Restart Host and MCU processes.
2018-08-26 00:19:52 +03:00
- User defineable macro buttons with optional parameter dialogs.
2018-01-24 19:30:01 +03:00
- Assisted bed leveling wizard with user definable probe points.
- PID Tuning Dialog.
- Dialog to set a coordinate offset for future GCODE move commands.
2018-01-27 17:04:32 +03:00
- Message log displaying messages from Klipper prepended with "//" and "!!".
2018-08-11 13:33:32 +03:00
- Basic Klipper configuration editor
2018-08-13 19:36:19 +03:00
- Performance graph displaying key parameters extracted from the Klipper logs.
2018-01-23 17:01:58 +03:00
2018-08-13 19:36:19 +03:00
## Installation
2018-01-23 17:01:58 +03:00
2018-08-23 15:17:53 +03:00
Search for "Klipper" in OctoPrints Plugin Manager.
![Message Log](docs/assets/img/install.png)
2018-08-23 16:00:39 +03:00
or install manually using this URL / zip:
2018-01-23 17:01:58 +03:00
https://github.com/mmone/OctoPrintKlipper/archive/master.zip
2018-08-13 19:36:19 +03:00
## Update
OctoPrint will inform you when a new version of this plugin becomes available.
2018-01-23 17:01:58 +03:00
## Configuration
2018-08-20 16:12:52 +03:00
Click on the wrench icon in the titlebar to open OctoPrints settings dialog. Select "OctoKlipper" at the bottom of the settings dialog.
2018-02-06 01:14:37 +03:00
2018-05-26 10:18:13 +03:00
## Contributions
Also for the moment this plugin does what I wanted it to do, it is far from finished, pull requests are welcome. If you want to get started, the OctoPrint Plugin API is quite well documented here: [docs.octoprint.org/en/master/plugins](http://docs.octoprint.org/en/master/plugins).
2018-02-06 01:14:37 +03:00
## Screenshots
2018-02-06 01:16:49 +03:00
#### Message Log
2018-02-06 01:14:37 +03:00
![Message Log](docs/assets/img/message-log.png)
2018-02-06 01:16:49 +03:00
#### Bed Leveling
2018-02-06 01:14:37 +03:00
![Bed Leveling](docs/assets/img/bed-leveling.png)
2018-02-06 01:16:49 +03:00
#### PID Tuning
![PID Tuning](docs/assets/img/pid-tuning.png)
#### Coordinate Offset
![Coordinate Offset](docs/assets/img/offset.png)
2018-02-06 01:16:49 +03:00
#### Settings
2018-05-26 10:18:13 +03:00
![Settings](docs/assets/img/settings.png)
2018-08-13 19:36:19 +03:00
2018-08-14 20:22:09 +03:00
#### Klipper Config
![Klipper Config](docs/assets/img/klipper-config.png)
2018-08-13 19:36:19 +03:00
#### Performance Graph
2018-08-14 20:22:09 +03:00
![Performance Grap](docs/assets/img/performance-graph.png)
2018-08-13 19:36:19 +03:00