This is an Android VNC server using contemporary Android 7+ APIs. It therefore does not require root access. In reverence to the venerable droid-VNC-server is is called droidVNC-NG.
If you have a general question, it's best to ask in the community chat. If your concern is about a bug or feature request instead, please use the issue tracker.
- Network export of device frame buffer with optional server-side scaling.
- Injection of remote pointer and basic keyboard events (Latin-1 charset plus some special keys, supporting any kind of UI widget on Android 14 and newer, on older devices into EditText widgets only).
- Handling of client-to-server text copy & paste. Note that server-to-client copy & paste only works automatically for text selected in editable text fields or manually by sharing text to droidVNC-NG via Android's Share-To functionality.
- Handling of special keys to trigger 'Recent Apps' overview, Home button, Back button and Power button.
- Android permission handling.
- Screen rotation handling.
- File transfer via the local network, assuming TightVNC viewer for Windows version 1.3.x is used.
- Password protection for secure-in-terms-of-VNC connection. Note that setting a password is mandatory in case you want to access the server using MacOS's built-in Screen Sharing app.
- Ability to specify the port used.
- Start of background service on device boot.
- Reverse VNC.
- Ability to connect to a UltraVNC-style Mode-2 repeater.
- Functionality to provide default configuration via a JSON file or Mobile Device Management.
- Zeroconf/Bonjour publishing for VNC server auto-discovery.
- Per-client mouse pointers on the controlled device.
- Ability to control a device’s shared screen directly from a web browser by shipping the fabulous noVNC client with the server app. This alleviates the need for a native VNC client.
- Ctrl-Shift-Esc triggers 'Recent Apps' overview
- Home/Pos1 acts as Home button
- End acts as Power button
- Escape acts as Back button
- Install the app from either marketplace.
- Get it all the permissions required.
- Set a good password and consider turning the
Start on Bootoff. - Connect to your local Wi-Fi. For accepting a connection your device should be connected to some Local Area Network that you can control, normally it is a router.
- Click
Startand connect to your device.
Disclaimer: Anything else than password exchange is currently not encrypted, so use at your own risk!
If you want to accept incoming connections from VNC viewers:
-
You should allow Port Forwarding in your router's Firewall settings. Either find a UPnP supported app to open ports dynamically or log in to your router's settings (usually open 192.168.1.1 in your browser, some routers have password written on them).
-
Find Port Forwarding, usually it's somewhere in Network - Firewall - Port Forwards.
-
Create a new rule, this is an example from OpenWRT firmware.
Name: VNC forwarding
Protocol: TCP
Source zone: wan may be "internet", "modem", something that suggests the external source.
External port: 5900 by default or whatever you specified in the app.
Destination zone: lan something that suggests local network.
Internal IP address: your device's local IP address, leaving any is less secure. The device's address may change over time! You can look it up in your routers' connected clients info.
Internal port: same as external port.
-
Apply the settings, sometimes it requires rebooting a router.
-
Figure out your public address i.e. https://www.hashemian.com/whoami/.
-
Use this address and port from above to connect to your device.
Here's how to connect to a listening VNC viewer or repeater without opening a server port:
- Leave the VNC port blank, which will get the Admin Panel to state the server isn't listening for incoming connections.
- Make outbound connections by choosing either "Connect to a listening viewer" or "Connect to a repeater".
DroidVNC-NG can be supplied with defaults for preferences that apply if preferences were not changed by the user.
See the Preseed Preferences Docs for more details.
droidVNC-NG features a remote control interface by means of Intents. This allows starting the VNC server from other apps or on certain events. It is designed to be working with automation apps like MacroDroid, Automate or Tasker as well as to be called from code.
See the Intent Interface Docs for more details.
- After cloning the repo, make sure you have the required git submodules set up via
git submodule update --init. - Then simply build via Android Studio or
gradlew.
Contributions to the project are very welcome and encouraged! They can come in many forms. You can:
- Submit a feature request or bug report as an issue.
- Provide info for issues that require feedback.
- Add features or fix bugs via pull requests. Please note there's a list of issues where contributions are especially welcome. Also, please adhere to the contribution guidelines.
-
Requires at least Android 7.
-
Since Android 10, the permission to access the screen contents has to be given on each start and is not saved. You can, however, work around this by installing adb (or simply Android Studio) on a PC, connecting the device running droidVNC-NG to that PC and running
adb shell cmd appops set net.christianbeier.droidvnc_ng PROJECT_MEDIA allowonce. Alternatively, if using the intent interface, you can also start withnet.christianbeier.droidvnc_ng.EXTRA_FALLBACK_SCREEN_CAPTUREset to true. -
You can also use adb to manually give input permission prior to app start via
adb shell settings put secure enabled_accessibility_services net.christianbeier.droidvnc_ng/.InputService:$(adb shell settings get secure enabled_accessibility_services). -
If you are getting a black screen in a connected VNC viewer despite having given all permissions, it might be that your device does not support Android's MediaProjection API correctly. To find out, you can try screen recording with another app, ScreenRecorder. If it fails as well, your device most likely does not support screen recording via MediaProjection. This is known to be the case for Android-x86.
-
In case you happen to have a board with an Ethernet interface and experience strange hangs during a VNC session, setting the interface to a slower speed might help. This workaround can be applied with mii-tool, for instance.
-
If you see a a floating button similar to this on your screen after enabling accessibility, make sure you have the "shortcut" option in accessibility settings turned to off.
-
Due to limitations in Android API, secondary displays are not supported.