mirror of
https://github.com/lxsang/antd-wvnc-plugin.git
synced 2024-12-26 20:08:22 +01:00
58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
# antd-wvnc-plugin
|
|
|
|
|
|
An [Antd HTTP/HTTPS server's](https://github.com/lxsang/ant-http) plugin that acts as a bridge between a VNC server and web applications. It allows web application to communicate with VNC server using web socket via a predefined protocol and message format. Web application can use my dedicate javascript library called [**wvnc.js**](https://github.com/lxsang/wvnc.js) to communicate with the VNC server using the plugin.
|
|
|
|
To speed up the data transmission, **WVNC** uses **libjpeg** for image compression.
|
|
|
|
## Build from source
|
|
As **WVNC** is an **Antd's** plugin, the server need to be pre-installed:
|
|
|
|
### build dep
|
|
* git
|
|
* make
|
|
* build-essential
|
|
* ant-http (libantd.so)
|
|
|
|
|
|
### Plugin Dependencies
|
|
* libjpeg-turbo
|
|
* libvncserver-dev
|
|
|
|
### build
|
|
When all dependencies are installed, the build can be done with a few single command lines:
|
|
|
|
```bash
|
|
# replace x.x.x by a version number
|
|
wget -O- https://get.iohub.dev/antd_plugin | bash -s "wvnc-x.x.x"
|
|
|
|
# or from the distribution tarball
|
|
tar xvzf wvnc-x.x.x.tar.gz
|
|
cd wvnc-x.x.x
|
|
./configure --prefix=/opt/www --enable-debug=yes
|
|
make
|
|
sudo make install
|
|
|
|
```
|
|
|
|
## Run
|
|
To run the Antd server with the **wvnc** plugin:
|
|
```sh
|
|
/path/to/your/build/antd
|
|
```
|
|
|
|
Web applications can be put on **/path/to/your/build/htdocs**, the web socket to **wvnc** is available at:
|
|
```
|
|
ws://your_host:your_port/wvnc
|
|
```
|
|
This websocket address can be used with my client side javascript library [**wvnc.js**](https://github.com/lxsang/wvnc.js) to provide web based VNC client
|
|
|
|
### Generate distribution
|
|
```sh
|
|
libtoolize
|
|
aclocal
|
|
autoconf
|
|
automake --add-missing
|
|
make distcheck
|
|
```
|