docs: add vnc examples close #1061

This commit is contained in:
alfrix 2023-07-29 16:12:44 -03:00 committed by Alfredo Monclus
parent 6d5eb09010
commit c27b3fefc4
2 changed files with 67 additions and 1 deletions

64
docs/VNC.md Normal file
View File

@ -0,0 +1,64 @@
# VNC
This article describes how to use KlipperScreen through a remote connection.
!!! warning
The experience may not be equal to run KlipperScreen natively,
depending on the device and network there maybe performance degradation or other issues
## On the Host device (for example a Raspberry Pi):
1. [First installl KlipperScreen](Installation.md)
2. Install a vnc server package, for example:
```bash
sudo apt install tigervnc-standalone-server
```
3. Create `launch_KlipperScreen.sh`:
```bash
#!/usr/bin/env bash
# Use display 10 to avoid clashing with local X server, if anyy
Xtigervnc -rfbport 5900 -noreset -AlwaysShared -SecurityTypes none :10&
DISPLAY=:10 $KS_XCLIENT&
wait
```
4. Restart KlipperScreen or reboot the system:
```bash
sudo systemctl service KlipperScreen restart
```
5. On KlipperScreen set the following configuration:
Display timeout: off
DPMS: off
## On the remote device:
1. Installa a VNC viewer and configure it to the ip of the host.
???+ example "Example using an iPad"
* Install a VNC viewer for example: `RealVNC Viewer: Remote Desktop`
#### Prevent unwanted rotation of UI:
* Go to `Settings` > `General` > Set `Use side switch to` to `Lock Rotation`
#### Avoid accidentally switching between apps:
* Go to `Restrictions` > Set passcode > Enable restrictions.
* Open
* Triple-click "Home" button
* Guided access pops up
* Press "Start"
* Now iPad is locked to VNC viewer until "Guided access" mode is disabled by triple-clicking "Home" button and entering the restrictions password.
#### On the VNC viewer:
* Press "+" button at the top right
* Enter IP address of your print host.
* Press "Save"
* Select "Interaction", select "Touch panel", go back
* Press "Done"
* Double-click on an icon with IP address you have just added.
* VNC client will complain about unencrypted connection. Disable the warning and say "Connect"
* Use or skip tutorial
* Press the "Pin" icon to hide the panel.
* Enjoy!

View File

@ -13,8 +13,10 @@ nav:
- Configuration.md
- Quicktips.md
- Macros: macros.md
- Android.md
- Thumbnails.md
- Remote screens:
- VNC.md
- Xserver-XSDL (Android): Android.md
- Troubleshooting:
- First Steps/Log: Troubleshooting.md
- Network: Troubleshooting/Network.md