ShellCam

ShellCam is a simple command-line tool for Linux that lets you create a virtual webcam. You can use it to show images, play local video files, or stream video from a URL directly to the virtual webcam. This can be useful for video calls, testing, or streaming. It uses v4l2loopback to create the virtual webcam and ffmpeg to handle the video input.

Examples

This allows you, for example, to use your phone as a webcam. Just install the IP Webcam App, start the video stream, and use the address shown at the bottom like this:

shellcam-cli remote start http://192.168.178.75:8080/video

Note

The /video part is important! You can configure rotation, resolution, front or back camera, etc., inside the app. I suggest starting at 720p, depending on your wireless speed.

If you want to set a locally stored image or video as your camera, you can do it like this:

shellcam-cli virtual start ~/Pictures/image.png

Dependencies

v4l2loopback-dkms
ffmpeg

Installation

1. Clone the repository:

git clone --depth 1 https://github.com/Justus0405/ShellCam.git

2. Navigate to the directory:

cd ShellCam

3. Make the script executable:

chmod +x shellcam-cli

4. Run the script with the install argument:

./shellcam-cli install

Usage

usage: shellcam-cli [...]
arguments:
         install
         uninstall
         udpate
         remote start URL
         remote stop
         virtual start FILEPATH
         virtual stop
         stop
         status
         help
         version

Copyright © 2025-present Justus0405