{"id":30442573,"url":"https://github.com/justus0405/shellcam","last_synced_at":"2026-05-01T18:32:40.643Z","repository":{"id":306767734,"uuid":"1027152763","full_name":"Justus0405/ShellCam","owner":"Justus0405","description":"📷 A minimal tool for creating, using and managing virtual and remote webcams on linux","archived":false,"fork":false,"pushed_at":"2025-12-18T18:54:46.000Z","size":21,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-30T01:42:18.858Z","etag":null,"topics":["bash","bash-script","ffmpeg","lightweight","linux","minimal","v4l2loopback","virtual-webcam","webcam"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Justus0405.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-27T12:31:24.000Z","updated_at":"2026-03-11T14:19:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"214fb0a3-985b-43a7-9446-cd185a6c6882","html_url":"https://github.com/Justus0405/ShellCam","commit_stats":null,"previous_names":["justus0405/shellcam"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Justus0405/ShellCam","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FShellCam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FShellCam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FShellCam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FShellCam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Justus0405","download_url":"https://codeload.github.com/Justus0405/ShellCam/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Justus0405%2FShellCam/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32508901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","bash-script","ffmpeg","lightweight","linux","minimal","v4l2loopback","virtual-webcam","webcam"],"created_at":"2025-08-23T08:35:04.532Z","updated_at":"2026-05-01T18:32:40.632Z","avatar_url":"https://github.com/Justus0405.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"left\"\u003e\n    \u003c!-- Discord Badge --\u003e\n    \u003ca href=\"https://discord.justus0405.com/\"\u003e\u003cimg src=\"https://img.shields.io/discord/1370519315400495234?logo=Discord\u0026colorA=1e1e2e\u0026colorB=a6e3a1\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003c!-- Version Badge --\u003e\n    \u003ca href=\"https://github.com/Justus0405/ShellCam/blob/main/ShellCam.sh\"\u003e\u003cimg src=\"https://img.shields.io/badge/Version-1.0-blue?colorA=1e1e2e\u0026colorB=cdd6f4\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"left\"\u003e\n    \u003c!-- Stars Badge --\u003e\n\t\u003ca href=\"https://github.com/Justus0405/ShellCam/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/Justus0405/ShellCam?colorA=1e1e2e\u0026colorB=b7bdf8\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003c!-- Issues Badge --\u003e\n\t\u003ca href=\"https://github.com/Justus0405/ShellCam/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/Justus0405/ShellCam?colorA=1e1e2e\u0026colorB=f5a97f\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003c!-- Contributors Badge --\u003e\n\t\u003ca href=\"https://github.com/Justus0405/ShellCam/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/Justus0405/ShellCam?colorA=1e1e2e\u0026colorB=a6da95\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# ShellCam\n\nShellCam 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.\n\n# Examples\n\nThis 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:\n\n```shell\nshellcam-cli remote start http://192.168.178.75:8080/video\n```\n\n\u003e [!NOTE]\n\u003e The `/video` part is important!\n\u003e You can configure rotation, resolution, front or back camera, etc., inside the app. I suggest starting at 720p, depending on your wireless speed.\n\nIf you want to set a locally stored image or video as your camera, you can do it like this:\n\n```shell\nshellcam-cli virtual start ~/Pictures/image.png\n```\n\n## Dependencies\n\n```plaintext\nv4l2loopback-dkms\nffmpeg\n```\n\n## Installation\n\n1. Clone the repository:\n\n```shell\ngit clone --depth 1 https://github.com/Justus0405/ShellCam.git\n```\n\n2. Navigate to the directory:\n\n```shell\ncd ShellCam\n```\n\n3. Make the script executable:\n\n```shell\nchmod +x shellcam-cli\n```\n\n4. Run the script with the install argument:\n\n```shell\n./shellcam-cli install\n```\n\n## Usage\n\n```plaintext\nusage: shellcam-cli [...]\narguments:\n         install\n         uninstall\n         udpate\n         remote start URL\n         remote stop\n         virtual start FILEPATH\n         virtual stop\n         stop\n         status\n         help\n         version\n```\n\n#\n\n\u003cp align=\"center\"\u003e\n\tCopyright \u0026copy; 2025-present \u003ca href=\"https://github.com/Justus0405\" target=\"_blank\"\u003eJustus0405\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://github.com/Justus0405/ShellCam/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/Justus0405/ShellCam?logo=Github\u0026colorA=1e1e2e\u0026colorB=cba6f7\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustus0405%2Fshellcam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustus0405%2Fshellcam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustus0405%2Fshellcam/lists"}