https://github.com/sshtools/rdp2vnc
An RDP to VNC bridge
https://github.com/sshtools/rdp2vnc
Last synced: 11 months ago
JSON representation
An RDP to VNC bridge
- Host: GitHub
- URL: https://github.com/sshtools/rdp2vnc
- Owner: sshtools
- License: gpl-3.0
- Created: 2017-08-22T12:28:32.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2018-02-21T15:46:54.000Z (over 8 years ago)
- Last Synced: 2025-06-10T23:46:55.497Z (about 1 year ago)
- Language: Java
- Size: 32.2 KB
- Stars: 11
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rdp2vnc
This library makes use of SSHTools' RDP component (originally based on properoRDP) and our own
Java RFB/VNC server.
It consists of a single 'Display Driver' implementation that plugs in to the RFB server and makes a
connection to a remote RDP server using an in-memory backing store. This backing store is then
served over VNC to any remote clients.
Mouse and keyboard events from clients are also sent to the RDP server, and there is some support
for other control events such as desktop resizing.
In short, it is an RDP-to-VNC bridge.
## Driver
The SSHTools RFB Server driver is *com.sshtools.rdp2vnc.RDPDisplayDriver*. You will most definitely
need to study the Example below for how to build it into your own application. The driver has
no particular requirements on how the I/O is done between the RFB server and your viewers, and
the RDP client and it's target host.
The general idea is :-
* You start an RFB server using this 'Driver'
* You start an RDP client connection using the same driver instance as the 'Display'
* You connect the I/O streams of each to each other
## Standalone application and Example
Included in the library is a simple command line driven standalone application that serves as both
as an example, and as a useful application if you want to access Windows hosts using a VNC client
(this is deal for the HTML5 based noVNC) without installing a VNC service on the target server.
The example will set up a TCP/IP server on port 5900 (by default) and connect to port 3389. You
can then connect any VNC viewer to port 5900 and should see the desktop being served on port 3389.
By using --help, the following will be displayed detailing all possible options.
```
usage: RDP2VNC [-?] [-b ] [-C] [-c ] [-d ] [-D ] [-e
] [-E] [-f] [-k ] [-l ] [-L ] [-m ] [-N]
[-p ] [-s ] [-S] [-v ] [-w ] [-W ]
A server to allow connections to RDP servers from VNC clients
-?,--help Display help
-b,--backlog Maximum number of incoming connections that
are allowed. Only applies in 'listen' mode
-C,--console Connect to the target RDP server's console.
-c,--command Run this command upon logon to the target
RDP server.
-d,--username The optional windows username to
authenticate with. If not supplied, the
user will be prompted.
-D,--directory Directory to be placed in upon logon to the
target RDP server.
-e,--encodings Comma separated list of enabled encoding
-E,--packet-encryption Enable packet encryption between the
RDP2VNC server and the RDP target.
-f,--full-screen Request full screen desktop from the remote
server (it's native resolution).
-k,--keymap The keyboard map. Defaults to en-us.
-l,--log Log level
-L,--listen-address The address and port to listen on in the
format
[:]. Address defaults
to 0.0.0.0 (all interfaces) and port
defaults to 3389
-m,--mode Connection mode. May either be 'listen'
(the default), or 'reverse' for to connect
to a VNC viewer running in listen mode
-N,--nocopyrect Do not use the CopyRect driver for window
movement (if supported)
-p,--password The optional windows password to
authenticate with. If not supplied, the
user will be prompted.
-s,--size The size of remote desktop to request from
the RDP server (defaults to 800x600). Use
the format ,
-S,--ssl Enable SSL encryption between the RDP2VNC
server and the RDP target.
-v,--viewport Serve only a rectangular viewport of the
entire desktop.Use the format
,,,.
-w,--vnc-password The password that VNC clients must
authenticate with. NOTE, this is not the
Windows password used to authenticate with
the RDP server.
-W,--vnc-passwordfile A file containing the VNC password that
clients must authenticate with. NOTE, this
is not the Windows password used to
authenticate with the RDP server.
Provided by SSHTOOLS Limited.
```