Namespace camera

Module for discovering and interacting with camera devices. This module lets you enumerate cameras, capture still images, and react to device connect/disconnect events in real time. Camera access requires user permission. Call hs.permissions.requestCamera() before using captureImage() or reading isInUse.

Enumerating cameras

const cameras = hs.camera.all()
cameras.forEach(cam => {
   console.log(cam.name + " — " + (cam.isInUse ? "in use" : "idle"))
})
Copy

Finding a specific camera

const cam = hs.camera.findByName("FaceTime HD Camera")
if (cam) {
   cam.captureImage()
       .then(img => img.saveToFile("/tmp/snapshot.png"))
       .catch(err => console.error("Capture error: " + err))
}
Copy

Watching for connect / disconnect events

const handler = (event, camera) => {
   if (event === "connected")    console.log("Camera connected: " + camera.name)
   if (event === "disconnected") console.log("Camera disconnected: " + camera.name)
}
hs.camera.addWatcher(handler)
// Later…
hs.camera.removeWatcher(handler)
Copy

Watching a camera's in-use state

const cam = hs.camera.all()[0]
cam.addWatcher((isInUse) => {
   console.log(cam.name + " is now " + (isInUse ? "in use" : "idle"))
})
Copy