{"id":19325181,"url":"https://github.com/locaal-ai/obs-detect","last_synced_at":"2025-05-11T06:31:03.922Z","repository":{"id":230095457,"uuid":"777909161","full_name":"locaal-ai/obs-detect","owner":"locaal-ai","description":"Object Detection in OBS, real-time, local, GPU optional","archived":false,"fork":false,"pushed_at":"2024-06-02T04:46:23.000Z","size":26169,"stargazers_count":87,"open_issues_count":16,"forks_count":8,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-14T08:32:30.212Z","etag":null,"topics":["computer-vision","live-streaming","livestreaming","object-detection","object-tracking","obs-studio","obs-studio-plugin","obsproject","video-object-tracking","yolo"],"latest_commit_sha":null,"homepage":"https://obsproject.com/forum/resources/detect-object-detection-tracking-built-in-obs.1911/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/locaal-ai.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}},"created_at":"2024-03-26T18:20:14.000Z","updated_at":"2024-11-08T22:07:28.000Z","dependencies_parsed_at":"2024-06-20T01:47:09.203Z","dependency_job_id":"391af39c-8f47-4052-9a0e-2b2e1d2c1163","html_url":"https://github.com/locaal-ai/obs-detect","commit_stats":{"total_commits":49,"total_committers":1,"mean_commits":49.0,"dds":0.0,"last_synced_commit":"22895cd786fd7ae44dc706b8a261f4e01adc9b8d"},"previous_names":["occ-ai/obs-detect","locaal-ai/obs-detect"],"tags_count":6,"template":false,"template_full_name":"obsproject/obs-plugintemplate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/locaal-ai%2Fobs-detect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/locaal-ai%2Fobs-detect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/locaal-ai%2Fobs-detect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/locaal-ai%2Fobs-detect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/locaal-ai","download_url":"https://codeload.github.com/locaal-ai/obs-detect/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225018872,"owners_count":17407948,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["computer-vision","live-streaming","livestreaming","object-detection","object-tracking","obs-studio","obs-studio-plugin","obsproject","video-object-tracking","yolo"],"created_at":"2024-11-10T02:09:10.878Z","updated_at":"2025-05-11T06:31:03.909Z","avatar_url":"https://github.com/locaal-ai.png","language":"C++","funding_links":["https://github.com/sponsors/royshil","https://github.com/sponsors/umireon"],"categories":[],"sub_categories":[],"readme":"# ⚠️ Stalled ⚠️ This project is not under active development\n\n## OBS Detect - Object Detection and Masking Filter\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub](https://img.shields.io/github/license/occ-ai/obs-detect)](https://github.com/occ-ai/obs-detect/blob/main/LICENSE)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/occ-ai/obs-detect/push.yaml)](https://github.com/occ-ai/obs-detect/actions/workflows/push.yaml)\n[![Total downloads](https://img.shields.io/github/downloads/occ-ai/obs-detect/total)](https://github.com/occ-ai/obs-detect/releases)\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/occ-ai/obs-detect)](https://github.com/occ-ai/obs-detect/releases)\n[![Discord](https://img.shields.io/discord/1200229425141252116)](https://discord.gg/KbjGU2vvUz)\n\n\u003c/div\u003e\n\nA plugin for [OBS Studio](https://obsproject.com/) that allows you to detect many types of objects in any source, track them and apply masking.\n\nIf you like this work, which is given to you completely free of charge, please consider supporting it by sponsoring us on GitHub:\n\n- https://github.com/sponsors/royshil\n- https://github.com/sponsors/umireon\n\nThis work uses the great contributions from [EdgeYOLO-ROS](https://github.com/fateshelled/EdgeYOLO-ROS) and [PINTO-Model-Zoo](https://github.com/PINTO0309/PINTO_model_zoo). The Hungarian algorithm is taken from https://github.com/Gluttton/munkres-cpp under the GPLv2 license.\n\n## Usage\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://youtu.be/LrbUrvaGreQ\"\u003e\u003cimg width=\"40%\" src=\"https://github.com/occ-ai/obs-detect/assets/441170/b8e7367e-c1b0-4c7e-b0df-af45ead87199\" /\u003e\u003c/a\u003e\u0026nbsp;\n\u003ca href=\"https://youtu.be/zmdq1bPVYs0\"\u003e\u003cimg width=\"40%\" src=\"https://github.com/occ-ai/obs-detect/assets/441170/2eb08589-1695-4a40-877e-4985c2b5270f\" /\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n- Add the \"Detect\" filter to any source with an image (Media, Browser, VLC, Image, etc.)\n- Enable \"Masking\" or \"Tracking\"\n\nUse Detect to track your pet, or blur out people in your video!\n\nMore information and usage tutorials to follow soon.\n\n## Features\n\nCurrent features:\n\n- Detect over 80 categories of objects, using an efficient model ([EdgeYOLO](https://github.com/LSH9832/edgeyolo))\n- 3 Model sizes: Small, Medium and Large\n- Face detection model, fast and efficient ([YuNet](https://github.com/opencv/opencv_zoo/tree/main/models/face_detection_yunet))\n- Load custom ONNX detection models from disk\n- Filter by: Minimal Detection confidence, Object category (e.g. only \"Person\"), Object Minimal Size\n- Masking: Blur, Pixelate, Solid color, Transparent, output binary mask (combine with other plugins!)\n- Tracking: Single object / Biggest / Oldest / All objects, Zoom factor, smooth transition\n- SORT algorithm for tracking smoothness and continuity\n- Save detections to file in real-time, for integrations e.g. with Streamer.bot\n\nRoadmap features:\n- Precise object mask, beyond bounding box\n- Multiple object category selection (e.g. Dog + Cat + Duck)\n- Make available detection information for other plugins through settings\n\n## Train and use a custom detection model\n\nFollow the instructions in [docs/train_model.md](docs/train_model.md) to train and use your own custom model.\n\n## Building\n\nThe plugin was built and tested on Mac OSX  (Intel \u0026 Apple silicon), Windows and Linux.\n\nStart by cloning this repo to a directory of your choice.\n\n### Mac OSX\n\nUsing the CI pipeline scripts, locally you would just call the zsh script. By default this builds a universal binary for both Intel and Apple Silicon. To build for a specific architecture please see `.github/scripts/.build.zsh` for the `-arch` options.\n\n```sh\n$ ./.github/scripts/build-macos -c Release\n```\n\n#### Install\nThe above script should succeed and the plugin files (e.g. `obs-ocr.plugin`) will reside in the `./release/Release` folder off of the root. Copy the `.plugin` file to the OBS directory e.g. `~/Library/Application Support/obs-studio/plugins`.\n\nTo get `.pkg` installer file, run for example\n```sh\n$ ./.github/scripts/package-macos -c Release\n```\n(Note that maybe the outputs will be in the `Release` folder and not the `install` folder like `pakage-macos` expects, so you will need to rename the folder from `build_x86_64/Release` to `build_x86_64/install`)\n\n### Linux (Ubuntu)\n\nUse the CI scripts again\n```sh\n$ ./.github/scripts/build-linux.sh\n```\n\nCopy the results to the standard OBS folders on Ubuntu\n```sh\n$ sudo cp -R release/RelWithDebInfo/lib/* /usr/lib/x86_64-linux-gnu/\n$ sudo cp -R release/RelWithDebInfo/share/* /usr/share/\n```\nNote: The official [OBS plugins guide](https://obsproject.com/kb/plugins-guide) recommends adding plugins to the `~/.config/obs-studio/plugins` folder.\n\n### Windows\n\nUse the CI scripts again, for example:\n\n```powershell\n\u003e .github/scripts/Build-Windows.ps1 -Target x64\n```\n\nThe build should exist in the `./release` folder off the root. You can manually install the files in the OBS directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocaal-ai%2Fobs-detect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flocaal-ai%2Fobs-detect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocaal-ai%2Fobs-detect/lists"}