{"id":13582391,"url":"https://github.com/golift/securityspy","last_synced_at":"2026-03-08T08:05:09.358Z","repository":{"id":45601576,"uuid":"164207135","full_name":"golift/securityspy","owner":"golift","description":"Full Featured Go Library for SecuritySpy","archived":false,"fork":false,"pushed_at":"2026-03-03T03:12:04.000Z","size":3537,"stargazers_count":14,"open_issues_count":1,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-03-03T06:42:32.702Z","etag":null,"topics":["ffmpeg-libraries","go","go-library","golang","golang-library","motion-capture","security-cameras","securityspy"],"latest_commit_sha":null,"homepage":"https://golift.io/discord","language":"Go","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/golift.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":"securityspy.go","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":"2019-01-05T11:05:15.000Z","updated_at":"2026-03-03T03:11:44.000Z","dependencies_parsed_at":"2024-01-19T08:14:39.949Z","dependency_job_id":"54cf2a22-a5cb-41cd-b576-7bd6310c93c9","html_url":"https://github.com/golift/securityspy","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/golift/securityspy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/golift%2Fsecurityspy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/golift%2Fsecurityspy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/golift%2Fsecurityspy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/golift%2Fsecurityspy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/golift","download_url":"https://codeload.github.com/golift/securityspy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/golift%2Fsecurityspy/sbom","scorecard":{"id":434855,"data":{"date":"2025-08-11","repo":{"name":"github.com/golift/securityspy","commit":"6317e4b8150ccfa6c775b0ac5696b5024449496c"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.5,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/17 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":"Maintained","score":0,"reason":"1 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":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","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":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Info: topLevel 'contents' permission set to 'read': .github/workflows/codetests.yml:7","Info: no jobLevel write permissions found"],"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":"Pinned-Dependencies","score":2,"reason":"dependency not pinned by hash detected -- score normalized to 2","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codetests.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/golift/securityspy/codetests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codetests.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/golift/securityspy/codetests.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/codetests.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/golift/securityspy/codetests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codetests.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/golift/securityspy/codetests.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/codetests.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/golift/securityspy/codetests.yml/main?enable=pin","Info:   3 out of   6 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned"],"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":"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":"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":"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":"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":"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":"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":"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":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 29 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-19T04:21:18.613Z","repository_id":45601576,"created_at":"2025-08-19T04:21:18.613Z","updated_at":"2025-08-19T04:21:18.613Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30111728,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T03:40:26.266Z","status":"ssl_error","status_checked_at":"2026-03-05T03:39:15.902Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["ffmpeg-libraries","go","go-library","golang","golang-library","motion-capture","security-cameras","securityspy"],"created_at":"2024-08-01T15:02:40.215Z","updated_at":"2026-03-05T05:02:56.986Z","avatar_url":"https://github.com/golift.png","language":"Go","readme":"# go-securityspy\n\n![reportcard](https://goreportcard.com/badge/golift.io/securityspy)\n\n## OVERVIEW\n\nFull Featured Go Library for [SecuritySpy](https://www.bensoftware.com/securityspy/)'s\nweb API. Read about the [API here](https://www.bensoftware.com/securityspy/web-server-spec.html).\n\nEverything is reasonably tested and working. Feedback is welcomed!\n\n`ffmpeg` is used if you want video snippets, but not required for most functions.\n\nA command line interface app that uses this library exists. Most of the testing is done with this app.\nFind it here: [https://github.com/davidnewhall/SecSpyCLI](https://github.com/davidnewhall/SecSpyCLI)\nIt's full of great examples on how to use this library, and can be easily installed with homebrew.\n\n-   Works with SecuritySpy 4 and 5 and probably 6.\n-   There's a lot more to learn about this package in [GODOC](https://godoc.org/golift.io/securityspy).\n\n## FEATURES\n\n#### Server\n\n-   All server and system Info is exposed with one API web request.\n-   Schedule Presets can be retrieved and invoked.\n\n#### Settings\n\n-   No support for settings yet.\n\n#### Cameras\n\n-   Stream live H264 or MJPEG video from an `io.ReadCloser`.\n-   Stream live G711 audio from an `io.ReadCloser`.\n-   Submit G711 audio (files or microphone) to a camera from an `io.ReadCloser`.\n-   Save live video snippets locally (requires `FFMPEG`).\n-   Get live JPEG images in `image` format, or save files locally.\n-   Arm and Disarm actions, motion capture and continuous capture.\n-   Trigger Motion.\n-   Set schedules and schedule overrides.\n-   Inspect PTZ capabilities.\n-   Control all PTZ actions including invoking and saving presets.\n\n#### Events\n\nSecuritySpy has a handy event stream; you can bind functions and/or channels to\nall or specific events. When a bound event fires the callback method it's bound\nto is run. In the case of a channel binding, the event is sent to the channel\nfor consumption by a worker (pool).\n\n-   Exposes all SecuritySpy events.\n-   Exposes 6 custom events.\n-   Method to inject custom events into the event stream.\n\n#### Files\n\nSecuritySpy saves video and image files based on motion and continuous capture\nsettings. These files can be listed and downloaded with this library.\n\n-   List and retrieve captured images.\n-   List and retrieve continuous captured videos.\n-   List and retrieve motion captured videos.\n-   Save files locally or stream from `io.ReadCloser`.\n\n## EXAMPLE\n\nThis example shows some of the data that is provided by the API. None of the\nactions methods are invoked here. See the [SecSpyCLI](https://github.com/davidnewhall/SecSpyCLI/blob/master/cmd/secspy/main.go)\napp for examples of other methods.\n\n```golang\npackage main\n\nimport (\n\t\"fmt\"\n\t\"time\"\n\n\t\"golift.io/securityspy\"\n\t\"golift.io/securityspy/server\"\n)\n\nfunc main() {\n\tsspy, err := securityspy.New(\u0026server.Config{\n\t\tUsername:  \"admin\",\n\t\tPassword:  \"password\",\n\t\tURL:       \"http://127.0.0.1:8000\",\n\t\tTimeout:   time.Minute,\n\t\tVerifySSL: false,\n\t})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tscripts, _ := sspy.GetScripts()\n\tsounds, _ := sspy.GetSounds()\n\n\t// Print server info.\n\tfmt.Printf(\"%v %v @ %v (http://%v:%v/) %d cameras, %d scripts, %d sounds, %d schedules, %d schedule presets\\n\",\n\t\tsspy.Info.Name, sspy.Info.Version, sspy.Info.CurrentTime,\n\t\tsspy.Info.IP1, sspy.Info.HTTPPort, len(sspy.Cameras.All()),\n\t\tlen(scripts), len(sounds), len(sspy.Info.ServerSchedules), len(sspy.Info.SchedulePresets))\n\n\t// Print info for each camera.\n\tfor _, camera := range sspy.Cameras.All() {\n\t\tfmt.Printf(\"%2v: %-14v (%-4vx%-4v %5v/%-7v %v) connected: %3v, down %v, modes: C:%-8v M:%-8v A:%-8v \"+\n\t\t\t\"%2vFPS, Audio:%3v, MD: %3v/pre:%v/post:%3v idle %-10v Script: %v (reset %v)\\n\",\n\t\t\tcamera.Number, camera.Name, camera.Width, camera.Height, camera.DeviceName, camera.DeviceType, camera.Address,\n\t\t\tcamera.Connected.Val, camera.TimeSinceLastFrame.String(), camera.ModeC.Txt, camera.ModeM.Txt,\n\t\t\tcamera.ModeA.Txt+\",\", int(camera.CurrentFPS), camera.HasAudio.Txt, camera.MDenabled.Txt,\n\t\t\tcamera.MDpreCapture.String(), camera.MDpostCapture.String(),\n\t\t\tcamera.TimeSinceLastMotion.String(), camera.ActionScriptName, camera.ActionResetTime.String())\n\t}\n}\n```\nThe output looks like this:\n```\nSecuritySpy 4.2.10b9 @ 2019-02-09 16:20:00 -0700 MST (http://192.168.1.1:8000/) 7 cameras, 18 scripts, 20 sounds, 6 schedules, 1 schedule presets\n 0: Porch          (2304x1296 ONVIF/Network 192.168.1.12) connected: true, down 0s, modes: C:armed    M:armed    A:armed,   20FPS, Audio:yes, MD: yes/pre:3s/post:10s idle 3h5m5s     Script: SS_SendiMessages.scpt (reset 1m0s)\n 1: Door           (2592x1520 ONVIF/Network 192.168.1.13) connected: true, down 0s, modes: C:armed    M:armed    A:armed,   15FPS, Audio:yes, MD: yes/pre:4s/post: 5s idle 9m24s      Script: SS_SendiMessages.scpt (reset 1m0s)\n 2: Road           (2592x1520 ONVIF/Network 192.168.1.11) connected: true, down 0s, modes: C:armed    M:armed    A:disarmed, 20FPS, Audio: no, MD: yes/pre:3s/post: 5s idle 4m35s      Script: SS_SendiMessages.scpt (reset 59s)\n 3: Garage         (3072x2048 ONVIF/Network 192.168.1.14) connected: true, down 0s, modes: C:armed    M:armed    A:armed,   20FPS, Audio:yes, MD: yes/pre:3s/post: 5s idle -1ns       Script: SS_SendiMessages.scpt (reset 1m0s)\n 4: Gate           (2560x1440 ONVIF/Network 192.168.1.16) connected: true, down 0s, modes: C:armed    M:armed    A:armed,   29FPS, Audio:yes, MD: yes/pre:3s/post: 5s idle -1ns       Script: SS_SendiMessages.scpt (reset 1m0s)\n 5: Pool           (3072x2048 ONVIF/Network 192.168.1.17) connected: true, down 0s, modes: C:armed    M:armed    A:armed,   10FPS, Audio:yes, MD: yes/pre:2s/post:20s idle 16m18s     Script: SS_SendiMessages.scpt (reset 1m0s)\n 6: Car            (2048x1536 ONVIF/Network 192.168.1.18) connected: true, down 0s, modes: C:armed    M:armed    A:armed,   20FPS, Audio: no, MD: yes/pre:0s/post:15s idle -1ns       Script: SS_SendiMessages.scpt (reset 48s)\n ```\n\n## LICENSE\n\n[MIT License](LICENSE)\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgolift%2Fsecurityspy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgolift%2Fsecurityspy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgolift%2Fsecurityspy/lists"}