NDScreen

NDScreen allows you to create a virtual screen on supported Linux machines and to mirror it to any Android device connected over USB, reaching sub-100ms latency.

Dependencies

Install the dependencies by running the following command:

$ sudo apt-get install libusb-1.0-0-dev libpthread-stubs0-dev libx264-dev ffmpeg make

Additionally, the EVDI kernel driver is required. Follow the instructions on the linked repository to install it.

Android Studio is also recommended for an easier installation of the client application on the connected devices.

Quick Start

1. Clone this repository:

   $ git clone git@github.com:MattiaCestari/ndscreen.git

2. In Android Studio open an existing project by navigating to the NDscreenApp/ folder. It should be automatically recognized as a project.

3. Ensure you have enabled the developer options on your Android device and that USB debugging is turned on. Connect the device to the computer using an USB cable.

4. Android Studio should recognize the connected device. Install the app on the device. After it opens automatically, close it.

5. Open a terminal inside the cloned repo. Compile the project using

   $ make ndscreen

6. Run the host application:

   $ ./ndscreen

   In some cases, you might need admin permissions:

   $ sudo ./ndscreen

7. Choose your device among the listed options by pressing the corresponding number followed by Enter.

8. At this point, a prompt should appear on the (unlocked) device. Press OK. The app should open automatically and start showing the newly created virtual display on the host computer.