Files
blelock/BLEunlock extension instructions.md
2026-04-30 00:57:24 +02:00

19 lines
1.8 KiB
Markdown

## INSTRUCTION
- Generate the gnome-shell 49 extension described under the _EXTENSION DESCRIPTION_ item.
- Place all output in a subdirectory named 'generated' in the working directory.
- Place a GPL-3.0 LICENSE.md file in the generated directory.
## EXTENSION DESCRIPTION:
- Features:
- The extension is called 'BLE Unlock' and is owned by daniel@demus.dk. The project is configured for developing in javascript.
- The extension monitors the signal strength of a bluetooth device in the proximity of the computer and calls functions when the signal strength goes below or above configured thresholds, respectively. The functions send a dbus message to then org.gnome.ScreenSaver method SetActive with boolean `true` when the RSSI falls over the threshold and boolean `false` when it goes over with a configurable delay, which is 3 seconds by default. Debug log the transitions.
- Include a quick settings item allowing to enable/disable the monitoring functionality and showing some status information including the selected device and current signal strength.
- The dB thresholds and device to monitor are configurable. The item must have a submenu allowing setting the thresholds and selecting which device to monitor, so the quick settings item it should list nearby devices and allow selecting one of them, similarly to the the gnome Bluetooth Settings dialog.
- The extension runs in user and unlock-dialogue session modes.
- Additional deliverables:
- Add comments to all non-boilerplate methods.
- Generate unit tests for all isolatable codepaths.
- Generate integration tests both with mocks and gnome-shell-test-tool as appropriate for the given functionality under test.
- Store any informational output related to the project or further instructions into a README.md file.