AVream¶
Turn your Android phone into a Linux virtual camera and microphone for real meetings and recordings — no dedicated phone app required.
Why AVream¶
- No dedicated app required on the phone — uses ADB and scrcpy.
- Phone-first UX: scan phone, select device, start camera in three clicks.
- USB and Wi-Fi modes with automatic reconnect flow.
- Registers as standard Linux devices:
AVream Camera(V4L2) andAVream Mic(PipeWire/PulseAudio). - Includes both GUI (
avream-ui) and CLI (avream) for automation. - Security model based on polkit helper actions — no
sudoin GUI controls. - UI available in English, Polski, Español, العربية, and 中文.
Works With¶
- Google Meet — select
AVream CameraandAVream Micin Meet settings - Zoom — select
AVream CameraandAVream Micin Zoom audio/video settings - OBS Studio — add
AVream Cameraas a V4L2 video capture source - Any app that supports standard Linux V4L2 camera and PulseAudio/PipeWire microphone devices
Quickstart (One-liner)¶
Install latest AVream:
curl -fsSL https://raw.githubusercontent.com/Kacoze/avream/main/scripts/install.sh | bash
Install specific version:
curl -fsSL https://raw.githubusercontent.com/Kacoze/avream/main/scripts/install.sh | AVREAM_VERSION=<version> bash
Launch:
avream-ui
Then:
- Go to Devices and click Scan Phones.
- Select your phone and click Connect.
- Go to Stream and click Start Camera.
CLI Quickstart¶
avream status
avream devices
avream start --mode wifi --lens front
avream camera stop
Full command reference: CLI Reference.
Install Options¶
- Recommended: one-liner installer (
scripts/install.sh). - Debian/Ubuntu: APT repository (
apt install avream) or.deb. - Fedora/openSUSE: monolithic RPM (
avream-<version>-1.x86_64.rpm). - Arch Linux: AUR package (
packaging/arch/). - Nix/NixOS: flake package (
.#avream). - Snap Store, Flatpak, and Ubuntu PPA also available.
Full guide: Install and Upgrade.
Known Limits¶
- PC audio output to phone speaker is not in stable baseline.
- Preview runs as a separate
scrcpywindow, not embedded in the GTK UI.
Releases¶
- Latest release: https://github.com/Kacoze/avream/releases/latest