Android Webcam

Portugues (Brasil) | English

Tip

For AppImage Builds: Scrcpy-Webcam

Use your Android device as a high-quality webcam on Linux via scrcpy and v4l2loopback.

📸 Screenshots

1. Launch & Settings	2. Mute Microphone	3. Change resolution

🛠️ Prerequisites

Before installing or building, ensure your system has the necessary drivers and tools:

For Debian / Ubuntu / Mint:

sudo apt update
sudo apt install v4l2loopback-dkms v4l2loopback-utils adb ffmpeg libsdl2-2.0-0

Install scrcpy (Debian 13+)

git clone https://github.com/Genymobile/scrcpy
cd scrcpy
./install_release.sh
cd ..

For Arch Linux:

# Install core dependencies
sudo pacman -S v4l2loopback-dkms v4l2loopback-utils android-tools ffmpeg sdl2 scrcpy dkms

# Install kernel headers (MATCH these to your running kernel)
sudo pacman -S linux-headers

# Load the module for the current session
sudo modprobe v4l2loopback

---

📥 Installation

For Debian:

sudo apt install ./android-webcam_*_amd64.deb

For Arch Linux:

Use the provided Arch build script to generate and install the package automatically.

---

🔧 Post-Install Setup

1. Bake into Kernel (Persistent Loading)

Debian / Ubuntu:

sudo update-initramfs -u

Arch Linux:

echo "v4l2loopback" | sudo tee /etc/modules-load.d/v4l2loopback.conf
echo "options v4l2loopback devices=1 video_nr=9 card_label='Android-Webcam' exclusive_caps=1" | sudo tee /etc/modprobe.d/v4l2loopback.conf
sudo mkinitcpio -P

2. User Permissions

sudo usermod -aG video $USER

(Note: Log out and back in for changes to take effect.)

---

🚀 Building and Testing

Standardized build scripts are provided for each distribution. Run the one that matches your OS:

1. Make scripts executable

chmod +x build-debian.sh build-arch.sh

2. Run the Build Script

If you are on Debian / Ubuntu / Mint:

./build-debian.sh

If you are on Arch Linux / EndeavourOS / Manjaro:

./build-arch.sh

---

📱 Usage

1. Connect:
   • Wired (USB): Plug in your phone via USB and enable USB Debugging.
   • Wireless (Wi-Fi):
     • From USB: Plug in phone once, then click 📶 Switch to Wi-Fi. Once connected, you can unplug the USB cable!
     • Direct Wi-Fi: On the waiting screen, enter your phone's IP address (and port, e.g. 192.168.1.50:5555) and click Connect.
2. Authorize: Tap Allow for the USB/Wireless debugging prompt on your phone.
3. Launch: Open Android Webcam from your App Menu or Terminal.
4. Configure: Select camera, resolution, and FPS, then click 🚀 Launch / Update.
5. Persistent Settings: Your last selected camera, resolution, FPS, mic mute state, and wireless IP are automatically saved as the defaults for your next session. You can also explicitly click 💾 Save Current as Default.
6. Select Source: In Zoom, OBS, Discord, or Google Meet, choose "Android-Webcam".

---

❤️ Credits

This project is built upon the incredible work of the scrcpy project.

• scrcpy GitHub: https://github.com/Genymobile/scrcpy