https://github.com/justus0405/shellcam
📷 A minimal tool for creating, using and managing virtual and remote webcams on linux
https://github.com/justus0405/shellcam
bash bash-script ffmpeg lightweight linux minimal v4l2loopback virtual-webcam webcam
Last synced: about 2 months ago
JSON representation
📷 A minimal tool for creating, using and managing virtual and remote webcams on linux
- Host: GitHub
- URL: https://github.com/justus0405/shellcam
- Owner: Justus0405
- License: mit
- Created: 2025-07-27T12:31:24.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-12-18T18:54:46.000Z (6 months ago)
- Last Synced: 2026-03-30T01:42:18.858Z (3 months ago)
- Topics: bash, bash-script, ffmpeg, lightweight, linux, minimal, v4l2loopback, virtual-webcam, webcam
- Language: Shell
- Homepage:
- Size: 20.5 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://play.google.com/store/apps/details?id=com.pas.webcam), start the video stream, and use the address shown at the bottom like this:
```shell
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:
```shell
shellcam-cli virtual start ~/Pictures/image.png
```
## Dependencies
```plaintext
v4l2loopback-dkms
ffmpeg
```
## Installation
1. Clone the repository:
```shell
git clone --depth 1 https://github.com/Justus0405/ShellCam.git
```
2. Navigate to the directory:
```shell
cd ShellCam
```
3. Make the script executable:
```shell
chmod +x shellcam-cli
```
4. Run the script with the install argument:
```shell
./shellcam-cli install
```
## Usage
```plaintext
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
