noVNC is a Python-based server that integrates noVNC and websockify to provide a web-based VNC client, enabling remote desktop access via a web browser.
Project description
noVNC
noVNC is a Python-based server that comes with included (websockify and noVNC) that utilizes noVNC and websockify to provide a web-based VNC client. This allows users to remotely access and control a desktop environment through their web browser.
Features
-
Easy Setup : Quickly integrate your VNC server and access it via a web browser.
-
Web-based Access : No need for a standalone VNC client; everything runs in the browser.
-
Secure Connection : Uses websockify to securely proxy WebSocket connections to the VNC server.
Requirements
-
Python 3.x
-
VNC server (e.g., TigerVNC, TightVNC)
Installation
Install via pip:
pip install novnc
Manual Installation:
To install Terminal Widgets locally, follow these steps:
-
Clone this repository to your local machine.
git clone https://github.com/imegeek/noVNC
-
Navigate to the cloned directory.
cd noVNC
-
Install the package using pip:
pip install .
orpip3 install .
This will install noVNC along with its dependencies from the local source files.
Options
-
--listen HOST:PORT
: Sets the proxy/webserver IP address and port to listen. Default ishttp://[::]:5800
. -
--target HOST:PORT
: Sets the VNC IP address and port to target.
Usage
Start the server by running the module:
novnc --listen <HOST:PORT> --target <VNC_SERVER_IP>:<VNC_SERVER_PORT>
Example
novnc --listen 0.0.0.0:8080 --target 127.0.0.1:5900
Now server will listens on 0.0.0.0:8080
and targets the VNC server at 127.0.0.1:5900
.
Configuration
To customize the program's behavior, you can use the --listen and --target options when running the executable.
Troubleshooting
- Connection Issues : Ensure the VNC server is running and accessible. Verify the IP and port.
License
This program is licensed under the MIT License. See the LICENSE file for details.
Acknowledgments
-
noVNC - Open source VNC client using HTML5 and WebSockets
-
websockify - WebSockets support for any application
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file novnc-1.0.2.tar.gz
.
File metadata
- Download URL: novnc-1.0.2.tar.gz
- Upload date:
- Size: 11.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | de82a14c8200cd5a88db1aa126c9eeb44279bfdc82a08a87dcd61ef521d177ee |
|
MD5 | 772183037574e4ef71071509a839c134 |
|
BLAKE2b-256 | 1224e7e0a8e68e35d37db252618e128521535e78044fed0d42eda87c7b3ab280 |
File details
Details for the file novnc-1.0.2-py3-none-any.whl
.
File metadata
- Download URL: novnc-1.0.2-py3-none-any.whl
- Upload date:
- Size: 11.8 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.0 CPython/3.12.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c7bb7368e504b40fcdbb21e112493e91fc273b5f25b60aad601bb7cb95e2da82 |
|
MD5 | be59a080166a65912e0765ba947978f6 |
|
BLAKE2b-256 | c25db48167f81fd6845c18e96ae3bd2fc8efe329e876dd565079c6af4bd1d406 |