Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/antonfisher/go-media-devices-state
Go module to get camera/microphone state -- checks if camera or microphone is ON
https://github.com/antonfisher/go-media-devices-state
camera golang microphone paranoia webcam
Last synced: 9 days ago
JSON representation
Go module to get camera/microphone state -- checks if camera or microphone is ON
- Host: GitHub
- URL: https://github.com/antonfisher/go-media-devices-state
- Owner: antonfisher
- License: mit
- Created: 2021-01-11T06:23:06.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-08-25T08:54:00.000Z (about 1 year ago)
- Last Synced: 2024-06-20T03:32:32.065Z (5 months ago)
- Topics: camera, golang, microphone, paranoia, webcam
- Language: Objective-C++
- Homepage:
- Size: 13.7 KB
- Stars: 21
- Watchers: 3
- Forks: 9
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# go-media-devices-state
[](https://goreportcard.com/report/github.com/antonfisher/go-media-devices-state)
[](https://conventionalcommits.org)
Go module to get camera/microphone state -- checks if camera/microphone is ON.
Module uses `cgo` to call native specific API on different platforms (currently only darwin is implemented.)
## Installation
```shell
go get github.com/antonfisher/go-media-devices-state
```
## Usage
```go
package main
import (
"fmt"
mediaDevices "github.com/antonfisher/go-media-devices-state"
)
func main() {
isCameraOn, err := mediaDevices.IsCameraOn()
if err != nil {
fmt.Println("Error:", err)
} else {
fmt.Println("Is camera on:", isCameraOn)
}
isMicrophoneOn, err := mediaDevices.IsMicrophoneOn()
if err != nil {
fmt.Println("Error:", err)
} else {
fmt.Println("Is microphone on:", isMicrophoneOn)
}
}
```
## Implemented APIs
| Platform | `IsCameraOn()` | `IsMicrophoneOn()` | `Debug()` | Details |
|----------|:--------------:|:------------------:|-----------|-----------------------------------------------------------------------|
| darwin | ☑ | ☑ | ☑ | Using `CoreMediaIO/CMIOHardware.h` and `CoreAudio/AudioHardware.h`API |
| linux | ☐ | ☐ | ☐ | |
| windows | ☐ | ☐ | ☐ | |
```go
// IsCameraOn returns true is any camera in the system is ON
func IsCameraOn() (bool, error)
// IsMicrophoneOn returns true is any microphone in the system is ON
func IsMicrophoneOn() (bool, error)
// Debug calls all available device functions and prints the results
func Debug()
```
## Demo
Demo prints out all system video devices and their states (ON/OFF):
```shell
git clone https://github.com/antonfisher/go-media-devices-state.git
cd go-media-devices-state
go run -a cmd/demo.go
```
Output example:
```
Debug go-media-devices-state module...
2021-01-12 23:04:53.674 demo[70272:606077] C.IsCameraOn()
2021-01-12 23:04:53.698 demo[70272:606077] C.IsCameraOn(): found devices: 1
2021-01-12 23:04:53.698 demo[70272:606077] C.IsCameraOn(): # | is used | description
2021-01-12 23:04:53.725 demo[70272:606077] C.IsCameraOn(): 0 | NO | 0x8020000005ac1234 (name: 'FaceTime HD Camera (Built-in)', model: 'UVC Camera VendorID_1234 ProductID_12345', is exclusively used: 0)
2021-01-12 23:04:53.725 demo[70272:606077] C.IsCameraOn(): failed devices: 0
2021-01-12 23:04:53.725 demo[70272:606077] C.IsCameraOn(): ignored devices (always on): 0
2021-01-12 23:04:53.725 demo[70272:606077] C.IsCameraOn(): is any camera on: NO
Camera state: OFF
2021-01-12 23:04:53.725 demo[70272:606077] C.IsMicrophoneOn()
2021-01-12 23:04:53.725 demo[70272:606077] C.IsMicrophoneOn(): found devices: 2
2021-01-12 23:04:53.725 demo[70272:606077] C.IsMicrophoneOn(): # | is used | description
2021-01-12 23:04:53.725 demo[70272:606077] C.IsMicrophoneOn(): 0 | NO | BuiltInMicrophoneDevice (name: 'MacBook Pro Microphone', model: 'Digital Mic', is exclusively used: 0)
2021-01-12 23:04:53.726 demo[70272:606077] C.IsMicrophoneOn(): failed audio devices: 0
2021-01-12 23:04:53.726 demo[70272:606077] C.IsMicrophoneOn(): ignored devices (speakers): 1
2021-01-12 23:04:53.726 demo[70272:606077] C.IsMicrophoneOn(): is any microphone on: NO
Microphone state: OFF
```
## Troubleshooting
List all registered cameras:
```shell
// macOS
system_profiler SPCameraDataType
```
List all registered microphones and speakers:
```shell
// macOS
system_profiler SPAudioDataType
```
## License
MIT License.