videocall-cli 4.1.2

Effortlessly stream video from the CLI with our native client, designed for your desktop, robot, or Raspberry Pi.
Documentation

Videocall-cli Rust Client

This is the official command-line client for videocall.rs, the open-source, ultra-low-latency video conferencing platform.

✨ Features

  • Stream video effortlessly from the CLI on your desktop, robot, or Raspberry Pi.
  • Works seamlessly with videocall.rs.
  • Currently Supports Chrome, Safari (both mobile and desktop), Chromium and Edge.
  • Compatible with local servers or production environments.

🛠️ Setup

System Requirements

We recommend using a Linux machine running Ubuntu 24 for the best experience.

1. Install Rust 🦀

Every install path below (cargo install, cargo run, cargo deb) needs the Rust toolchain, so do this first. The easiest way is via rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then restart your shell (or run source "$HOME/.cargo/env") so cargo is on your PATH. See the official install guide for alternatives.

2. Install Dependencies

Linux

Make sure you have the required libraries installed:

sudo apt install build-essential pkg-config libclang-dev libasound2-dev libv4l-dev cmake libssl-dev

macOS (experimental ⚠️)

First make sure the Xcode Command Line Tools are installed — they provide the C compiler and SDK headers needed to build native dependencies. (Homebrew's installer also pulls these in automatically if you don't have them yet.)

xcode-select --install

On macOS the native build pulls audio/video from CoreAudio and AVFoundation, so the Linux-only ALSA (libasound2) and V4L (libv4l) packages aren't needed. Install the rest with Homebrew:

brew install pkg-config llvm cmake openssl

The macOS camera backend is a Swift AVFoundation layer built by cargo at compile time, so the Xcode command-line tools (Swift toolchain) above are required — no extra runtime dependency.

Two macOS-specific behaviors to know when streaming:

  • Select the camera by UUID, not name. Pass the device's UUID (shown in the "Extras" field of info --list-cameras) as the --video-device-index value. See Quick Start below.
  • The requested resolution must be exact. The backend captures at exactly the resolution you request or fails with a clear error; it never silently substitutes a different size. Run videocall-cli info --list-formats <camera> to see the resolutions your camera actually supports.

VP9 encoding is pure Rust by default — no C libvpx is required or linked. If you need the legacy C libvpx backend (for A/B comparison or rollback), build with --features libvpx, which additionally requires libvpx-dev (Linux) / libvpx (macOS). The public behavior is the same either way.


🚀 Quick Start

Install via Cargo

  1. Skip the hassle! Install the client directly with:
cargo install videocall-cli
  1. List the cameras in your system:
videocall-cli info --list-cameras

There are 2 available cameras.
Name: NexiGo HD Webcam: NexiGo HD Web, Description: Video4Linux Device @ /dev/video4, Extra: , Index: 0
  1. Print the available resolutions and formats for your camera:
videocall-cli info --list-formats 0

Name: NexiGo HD Webcam: NexiGo HD Web, Description: uvcvideo, Extra: usb-0000:00:03.0-5 (6, 8, 12), Index: 0
YUYV:
 - 864x480: [10]
 - 1600x896: [5]
 - 1920x1080: [5]
NV12:
 - 640x480: [60, 30]
 - 1280x720: [60, 30]
 - 1920x1080: [60, 30]
  1. Start streaming:

⚠️ The meeting must already exist. Create the call first from a browser at videocall.rs — the CLI can only join an existing call, it can no longer create one. If the call's creator is the CLI, it will not work; a browser user has to create it.

videocall-cli \
  stream \
  --user-id <your-user-id> \
  --video-device-index 0 \
  --meeting-id <meeting-id> \
  --resolution 1280x720 \
  --fps 30 \
  --frame-format NV12 \
  --bitrate-kbps 500

🌐 See Your Stream Live! using Chrome or Safari

This system integrates directly with videocall.rs. Simply navigate to the following URL to watch your stream live:

https://app.videocall.rs/meeting/<meeting-id>

Replace <your-username> and <meeting-id> with the appropriate values.


🖥️ Supported Platforms

Platform Supported Tested
Ubuntu 24 (Linux) ✅ ✅
Ubuntu 22 (Linux) ✅ ✅
MacOS 15.3.1+ ⚠️(exp) ✅
Debian ✅ ❌
Alpine Linux ✅ ❌
Windows ❌ ❌

Run Locally

Stream your video to a meeting in seconds:

RUST_LOG=info cargo run --release -- ...

📦 Build a .deb Package

Want to create a Debian package? Easy!

  1. Install the necessary tool:
    cargo install cargo-deb
    
  2. Build the .deb package:
    cargo deb
    
    The package will be generated at: target/debian/videocall-cli...deb.
  3. Verify dependencies (optional):
    dpkg-deb -I <path_to_deb_file>
    
  4. Install the package:
    sudo dpkg -i <path_to_deb_file>
    

🎉 Ready to Stream?

Whether you're testing locally or connecting to production, Videocall-cli Rust Client is here to elevate your video streaming experience. Install it today and see the difference!


💡 Have questions or issues? Drop us a line! We're here to help.