{"id":28418999,"url":"https://github.com/mattravenhall/customcam","last_synced_at":"2026-04-29T15:04:04.539Z","repository":{"id":62566006,"uuid":"458647964","full_name":"mattravenhall/CustomCam","owner":"mattravenhall","description":"Extendable webcam customisation in Python.","archived":false,"fork":false,"pushed_at":"2022-02-20T18:19:09.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-17T07:45:27.804Z","etag":null,"topics":["face-detection","image-processing","mediapipe","opencv-python","v4l2loopback","webcam","webcam-background"],"latest_commit_sha":null,"homepage":"https://mattravenhall.github.io/2022/02/20/Custom-Webcam-Filtering.html","language":"Python","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/mattravenhall.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}},"created_at":"2022-02-12T21:52:20.000Z","updated_at":"2022-09-07T13:22:59.000Z","dependencies_parsed_at":"2022-11-03T17:47:24.472Z","dependency_job_id":null,"html_url":"https://github.com/mattravenhall/CustomCam","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mattravenhall/CustomCam","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattravenhall%2FCustomCam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattravenhall%2FCustomCam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattravenhall%2FCustomCam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattravenhall%2FCustomCam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattravenhall","download_url":"https://codeload.github.com/mattravenhall/CustomCam/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattravenhall%2FCustomCam/sbom","scorecard":{"id":627919,"data":{"date":"2025-08-11","repo":{"name":"github.com/mattravenhall/CustomCam","commit":"e16d5e2239dc2b03f571530e28adb339c903c2ab"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":0,"reason":"Found 0/2 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"39 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2018-34 / GHSA-2fc2-6r4j-p65h","Warn: Project is vulnerable to: PYSEC-2021-856 / GHSA-5545-2q6w-2gh6","Warn: Project is vulnerable to: PYSEC-2019-108 / GHSA-9fq2-x9r6-wfmf","Warn: Project is vulnerable to: PYSEC-2018-33 / GHSA-cw6w-4rcx-xphc","Warn: Project is vulnerable to: PYSEC-2021-857 / GHSA-f7c7-j99h-c22f","Warn: Project is vulnerable to: GHSA-fpfv-jqm9-f5jm","Warn: Project is vulnerable to: PYSEC-2017-1 / GHSA-frgw-fgh6-9g52","Warn: Project is vulnerable to: GHSA-267x-w5hx-8hjr","Warn: Project is vulnerable to: GHSA-33h2-69j3-r336","Warn: Project is vulnerable to: GHSA-3448-vrgh-85xr","Warn: Project is vulnerable to: GHSA-5rpc-gwh9-q9fg","Warn: Project is vulnerable to: GHSA-634c-v2xv-ffpg","Warn: Project is vulnerable to: GHSA-6v6p-p97v-g2p7","Warn: Project is vulnerable to: GHSA-83rh-hx5x-q9p5","Warn: Project is vulnerable to: GHSA-8849-5h85-98qw","Warn: Project is vulnerable to: GHSA-89rj-5ggj-3p9p","Warn: Project is vulnerable to: GHSA-8w3x-457r-wg53","Warn: Project is vulnerable to: GHSA-9g8h-pjm4-q92p","Warn: Project is vulnerable to: GHSA-c7gp-2pch-qh2v","Warn: Project is vulnerable to: GHSA-cvhw-2593-5j2q","Warn: Project is vulnerable to: GHSA-fffj-9qwg-qmh5","Warn: Project is vulnerable to: GHSA-fm39-cw8h-3p63","Warn: Project is vulnerable to: GHSA-fr58-2xhv-qp3w","Warn: Project is vulnerable to: GHSA-fvq6-392h-6mjj","Warn: Project is vulnerable to: GHSA-fw99-f933-rgh8","Warn: Project is vulnerable to: GHSA-hxfw-jm98-v4mq","Warn: Project is vulnerable to: GHSA-jcxv-2j3h-mg59","Warn: Project is vulnerable to: GHSA-jggw-2q6g-c3m6","Warn: Project is vulnerable to: GHSA-m43c-649m-pm48","Warn: Project is vulnerable to: GHSA-m6vm-8g8v-xfjh","Warn: Project is vulnerable to: GHSA-pqjj-6f5q-gqph","Warn: Project is vulnerable to: GHSA-q799-q27x-vp7w","Warn: Project is vulnerable to: GHSA-qr4w-53vh-m672","Warn: Project is vulnerable to: GHSA-rqxg-xvcq-3v2f","Warn: Project is vulnerable to: GHSA-vc29-rj92-gc7j","Warn: Project is vulnerable to: GHSA-w96g-3p64-63wr","Warn: Project is vulnerable to: GHSA-wq8f-wvqp-xvvm","Warn: Project is vulnerable to: GHSA-x3rm-644h-67m8","Warn: Project is vulnerable to: PYSEC-2023-183"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-21T07:00:03.250Z","repository_id":62566006,"created_at":"2025-08-21T07:00:03.251Z","updated_at":"2025-08-21T07:00:03.251Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32430803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["face-detection","image-processing","mediapipe","opencv-python","v4l2loopback","webcam","webcam-background"],"created_at":"2025-06-04T13:54:09.191Z","updated_at":"2026-04-29T15:04:04.502Z","avatar_url":"https://github.com/mattravenhall.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎥 CustomCam\n\nExtendable webcam customisation in Python.\n\nCustomCam uses [pyvirtualcamera](https://github.com/letmaik/pyvirtualcam) to interact with virtual output devices. As this package was primarily developed for Linux, the Quick Start commands address that use case. To set up virtual output devices for other platforms, check the [pyvirtualcam docs](https://github.com/letmaik/pyvirtualcam/blob/master/README.md).\n\n## Quick Start\n### Install\n```text\npip install CustomCam                    # Install CustomCam\nsudo apt install v4l2loopback-dkms       # Install virtual camera creator (Linux)\n```\n\n### Launch\n```text\nsudo modprobe v4l2loopback devices=1     # Create virtual camera (Linux)\nCustomCam                                # Launch CustomCam\n````\n\n## Usage\n### On-Launch\n```text\nusage: CustomCam [-h] [--input_camera INPUT_CAMERA]\n                 [--output_camera OUTPUT_CAMERA] [--fps]\n                 [--pref_width PREF_WIDTH] [--pref_height PREF_HEIGHT]\n                 [--pref_fps PREF_FPS]\n                 [--filter {Gray,NoFilter,Segment,Sepia,Shake,BlurBox,Frame,Pixel,BlurSat}]\n                 [--verbose] [--logfile]\n\n🎥 CustomCam. Extendable webcam modification on your commandline.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --input_camera INPUT_CAMERA\n                        ID of webcam device (default: 0)\n  --output_camera OUTPUT_CAMERA\n                        Dummy output device (default: /dev/video2)\n  --pref_width PREF_WIDTH\n                        Overwrite camera width. (default: None)\n  --pref_height PREF_HEIGHT\n                        Overwrite camera height. (default: None)\n  --pref_fps PREF_FPS   Overwrite camera fps. (default: None)\n  --filter {Gray,NoFilter,Segment,Sepia,Shake,BlurBox,Frame,Pixel,BlurSat}\n  --verbose             Enable verbose logging. (default: False)\n  --logfile             Write log to disk. (default: False)\n```\n\n### Mid-Run\nUsers are able to change the active filter, display statistics, flip the camera, close the program etc. whilst CustomCam is running by entering the appropriate command in the terminal in which CustomCam was launched.\n\n```text\nFilters:\n• 'BlurBox': Blur background via single face detection.\n• 'BlurSat': Blur background via saturation detection.\n• 'Frame': Highlight targets of face detection.\n• 'Gray': Apply grayscale.\n• 'NoFilter': Applies no filters.\n• 'Pixel': Pixelate individuals in the foreground.\n• 'Segment': Blur background using mediapipe's SelfieSegmentation.\n• 'Sepia': Apply sepia effect.\n• 'Shake': Shake two channels horizontally.\n\nOptions:\n• 'f', 'flip': Flip camera\n• 's', 'stats': Display statistics\n• 'h', 'help': Get this help\n• 'q', 'quit': Exit CustomCam\n```\n\n## Creating your own filters\nUser-defined filters can be added to `filters.py`.\n\nFilter classes must:\n- Inherit from `filters.Filter`\n- Implement a `__str__` method that return string containing a short description of the filter.\n- Implement an `apply` method which takes a frame (as a `np.array`), applies filter logic and returns that a `np.array`.\n- Not share a name with any existing class or input command.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattravenhall%2Fcustomcam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattravenhall%2Fcustomcam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattravenhall%2Fcustomcam/lists"}