Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rgolangh/gnome-shell-extension-camera-indicator
A Gnome Shell extension to indicate if a camera device is in use
https://github.com/rgolangh/gnome-shell-extension-camera-indicator
camera dbus ebpf gnome
Last synced: 14 days ago
JSON representation
A Gnome Shell extension to indicate if a camera device is in use
- Host: GitHub
- URL: https://github.com/rgolangh/gnome-shell-extension-camera-indicator
- Owner: rgolangh
- License: apache-2.0
- Created: 2020-11-25T08:59:43.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-10-02T08:23:50.000Z (over 1 year ago)
- Last Synced: 2024-11-07T10:53:18.342Z (2 months ago)
- Topics: camera, dbus, ebpf, gnome
- Language: JavaScript
- Homepage:
- Size: 13.7 KB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**Camera Indicator** is a gnome-shell extension that indicates when a camera or video devices is in use
This project is mostly exploratory to learn more about eBPF and DBUS but comes in handy for me to know when
my camera is on without me noticing.
## Dependencies
This extension works by listening on DBUS events sent to it whenever a camera or video device is in use.
To monitor those kernel events I use eBPF to trace C open calls on /dev/videoX devices, and
for every trace event there is a DBUS method_call event sent on the session bus, to the extension.
## Design
```
+-----------3. Gnome Shell Camera Indicator DBus object--------------+
| listends on a certain address on the |
| session bus, and toggles the indicator |
| accordingly |
| |
| +-----------2. eBPF trace in userspace-----------------+ |
| | catches the trace events and | |
| | emits a DBus event to the dbus | |
| | address of the extension | |
| | | |
| | +-----1. Kernel--------------+ | |
| | | eBPF sens and events | | |
| | | on each c:open call | | |
| | | for /dev/videoX | | |
| | | | | |
| | | | | |
| | | | | |
| | | | | |
| | | | | |
| | | | | |
| | +----------------------------+ | |
| +------------------------------------------------------+ |
+--------------------------------------------------------------------+
```
# Install using your browser
See the [gnome extensions page](https://extensions.gnome.org/extension/TODO/)
# Install from source
Checkout `master` branch for latest available, or `gnome-shell-x.xx` for a specific version.
Clone, Pack, and Install
```console
$ git clone https://github.com/rgolangh/gnome-shell-extension-camera-indicator
$ make all
// relogin to wayland or on xorg reload gnome-shell with Alt+F2 and r
```
Enalble using `make enable` or using 'Tweaks' -> Extensions -> toggle 'Containers'