Metadata-Version: 2.4
Name: jumpstarter-driver-vnc
Version: 0.8.2.dev207+g24473f342
Summary: Jumpstarter driver for VNC
Project-URL: Homepage, https://jumpstarter.dev
Project-URL: source_archive, https://github.com/jumpstarter-dev/jumpstarter/archive/24473f342f3744f0559275b3979d7754a37325a2.zip
Author-email: Albert Esteve <aesteve@redhat.com>
License-Expression: Apache-2.0
Requires-Python: >=3.11
Requires-Dist: anyio>=4.10.0
Requires-Dist: click
Requires-Dist: jumpstarter-driver-composite==0.8.2.dev207+g24473f342
Requires-Dist: jumpstarter-driver-network==0.8.2.dev207+g24473f342
Requires-Dist: jumpstarter==0.8.2.dev207+g24473f342
Description-Content-Type: text/markdown

# VNC Driver

`jumpstarter-driver-vnc` provides functionality for interacting with VNC servers. It allows you to create a secure, tunneled VNC session in your browser.

## Installation

```shell
pip3 install --extra-index-url https://pkg.jumpstarter.dev/simple/ jumpstarter-driver-vnc
```

## Configuration

The VNC driver is a composite driver that requires a TCP child driver to establish the underlying network connection. The TCP driver should be configured to point to the VNC server's host and port, which is often `127.0.0.1` from the perspective of the Jumpstarter server.

Example `exporter.yaml` configuration:

```yaml
export:
  vnc:
    type: jumpstarter_driver_vnc.driver.Vnc
    # You can set the default encryption behavior for the `j vnc session` command.
    # If not set, it defaults to False (unencrypted).
    default_encrypt: false
    children:
      tcp:
        type: jumpstarter_driver_network.driver.TcpNetwork
        config:
          host: "127.0.0.1"
          port: 5901 # Default VNC port for display :1
```

## API Reference

```{eval-rst}
.. autoclass:: jumpstarter_driver_vnc.driver.Vnc()
```
