forked from CreatBot/CreatBotKlipperScreen
docs: developer basic guide
This commit is contained in:
59
docs/Developers.md
Normal file
59
docs/Developers.md
Normal file
@@ -0,0 +1,59 @@
|
|||||||
|
# Developer Guide
|
||||||
|
|
||||||
|
Basic setup for an enviroment to do development of KlipperScreen.
|
||||||
|
|
||||||
|
!!! note "Alfrix Note:"
|
||||||
|
I use a standard Linux distro with a desktop enviroment.
|
||||||
|
|
||||||
|
## Clone the repo
|
||||||
|
Clone your fork, for example:
|
||||||
|
```
|
||||||
|
cd ~
|
||||||
|
git clone https://github.com/klipperscreen/klipperscreen.git
|
||||||
|
```
|
||||||
|
|
||||||
|
## Install the dependencies on the host
|
||||||
|
The X11 or Wayland dependencies should not be needed if you are running a desktop GNU/Linux distro.
|
||||||
|
See [scripts/system-dependencies.json](https://github.com/KlipperScreen/KlipperScreen/blob/master/scripts/system-dependencies.json)
|
||||||
|
|
||||||
|
## Create a virtual environment
|
||||||
|
For example:
|
||||||
|
```bash
|
||||||
|
virtualenv -p /usr/bin/python3 ~/.KlipperScreen-env
|
||||||
|
source ~/.KlipperScreen-env/bin/activate
|
||||||
|
cd ~/KlipperScreen
|
||||||
|
pip install -r scripts/klipperscreen-requirements.txt
|
||||||
|
```
|
||||||
|
# Set configurations
|
||||||
|
Create klipperscreen.conf and place it on the repo folder
|
||||||
|
```
|
||||||
|
[main]
|
||||||
|
show_cursor=True
|
||||||
|
# disable screen timeouts
|
||||||
|
use_dpms=False
|
||||||
|
screen_blanking=off
|
||||||
|
# disable Fullscreen and start in a specified size
|
||||||
|
# 480 x 320 is the minimum size to target
|
||||||
|
width=480
|
||||||
|
height=320
|
||||||
|
# setting width or height will disable fullscreen and it's the intended behavior
|
||||||
|
```
|
||||||
|
|
||||||
|
At this point you can add your actual printer section with the IP (and port of needed) to the config or/and add a virtual printer
|
||||||
|
|
||||||
|
# Optional: Virtual printer
|
||||||
|
|
||||||
|
You may use a virtual printer like it's described in the [klipper docs](https://www.klipper3d.org/Debugging.html#testing-with-simulavr),
|
||||||
|
or it's [alternative that uses docker](https://github.com/mainsail-crew/virtual-klipper-printer)
|
||||||
|
|
||||||
|
Using a Virtual printer will need klipper and moonraker need to be installed in the machine too.
|
||||||
|
|
||||||
|
!!! note
|
||||||
|
The virtual printer has various limitations,
|
||||||
|
like constant temperature and limited availability of pins,
|
||||||
|
it's not a limitation of klipperscreen
|
||||||
|
|
||||||
|
## Optional: Configure the IDE
|
||||||
|
|
||||||
|
* Set interpreter to the virtual environment created
|
||||||
|
* Set the run configuration to `KlipperScreen/screen.py`
|
@@ -33,6 +33,7 @@ nav:
|
|||||||
- Theming.md
|
- Theming.md
|
||||||
- Translations.md
|
- Translations.md
|
||||||
- Breaking Changes: Changelog.md
|
- Breaking Changes: Changelog.md
|
||||||
|
- Developers.md
|
||||||
|
|
||||||
- Contact.md
|
- Contact.md
|
||||||
theme:
|
theme:
|
||||||
|
Reference in New Issue
Block a user