| name | go-security-spy-sdk |
| description | Develop against or call golift.io/securityspy/v2 (Go SDK for SecuritySpy). Use when writing Go code that uses this library, fixing SDK types/methods, or when the user asks how to do something via the Go package rather than the live HTTP control skill. |
SecuritySpy Go SDK (golift.io/securityspy/v2)
Use this skill when working in Go with this repository’s client library. For interactive control of a live SecuritySpy server (schedules, snapshots, downloads), prefer the sibling securityspy-control skill and its Python CLI.
Offline API HTML + redacted fixtures: .archive/. Method index: reference.md.
Connect
sspy, err := securityspy.New(&server.Config{
Username: "...",
Password: "...",
URL: "https://host:8001",
VerifySSL: false,
})
- Auth is
auth= query param (base64 user:pass), not HTTP Basic.
New calls Refresh(). Lookup: Cameras.ByNum / ByName.- Do not call
Refresh() concurrently with other API use.
Common Go patterns
Schedule: cam.SetSchedule(CameraModeMotion, id) — IDs from Info.ServerSchedules. Prefer schedules over ToggleContinuous (ErrUnsupported / 404).
Snapshot: cam.SaveJPEG(&VidOps{Width: 1280, Quality: 80}, path) — fails if path exists.
Clip: cam.SaveVideo(ops, length, maxBytes, path) — pure-Go RTSP remux to file (H.264 + AAC); no ffmpeg. Prefer ACodec: "aac" (default). StreamVideo returns a progressive fMP4 pipe. UseHTTP is unsupported.
Recorded files: sspy.Files.GetMCVideos / GetImages / GetAll then file.Save(path).
Arm: ToggleMotion / ToggleActions; live status via Modes().
See reference.md for the full surface.
