AndroidDisplay - Quick Start Guide

This guide provides the quickest way to get up and running with AndroidDisplay.

Fedora Setup (One-time)

Install required packages:

sudo dnf install ffmpeg xrandr xdotool libva-utils python3 python3-pip

Install X11 dummy driver:
```
sudo dnf install xorg-x11-drv-dummy
```
Make sure you're running X11 (not Wayland):
```
echo $XDG_SESSION_TYPE
```
This should output x11. If it shows wayland, log out and select "KDE on X11" at the login screen.
Set up the virtual display manually:
```
sudo ./fedora-app/virtual-display.sh
```

Install the APK (either via Android Studio or sideloading):
- Build from source using Android Studio, or
- Copy the pre-built APK to your tablet and install it
Enable developer options and USB debugging on your tablet:
- Go to Settings > About tablet
- Tap Build number 7 times
- Go back to Settings > System > Developer options
- Enable USB debugging

Connect your tablet to your Fedora computer via USB-C
Enable USB tethering on your tablet:
- Go to Settings > Network & Internet > Hotspot & tethering
- Enable "USB tethering"

Start the streaming and input handler services:

# In one terminal
./fedora-app/stream-display.sh VIRTUAL1

# In another terminal
sudo python3 ./fedora-app/input-handler.py --display VIRTUAL1

Open the AndroidDisplay app on your tablet
Enter your Fedora system's IP address:
- Typically 192.168.42.1 when using USB tethering
- You can check with ip addr show
Tap "Connect" in the app
Your tablet should now display the content of your virtual display!

If the virtual display isn't recognized, try restarting your X session
If the app can't connect, check your IP address and make sure USB tethering is enabled

If video quality is poor, try:

./fedora-app/stream-display.sh VIRTUAL1 --quality=high