A Python 3 program used to lock your PC when a specified Bluetooth device is a certain distance away.
Bluetooth Proximity Locking only runs on Linux.
To install it, please run the following commands:
git clone https://github.com/mgrove36/bluetooth-proximity-locker.git
cd bluetooth-proximity-locker
chmod +x config
./config [options]
[options] must be 6 arguments long, corresponding to the following setup parameters:
- Bluetooth address -
xx:xx:xx:xx:xx:xx - Scan period (how often BTPL should scan for device connectivity status) - a number, in seconds
- Left range command (the command that is run when your chosen device leaves the specified range) - a string (e.g.
"gnome-screensaver-command -l") - Enters range command (the command that is run when your chosen device enters the specified range) - a string (e.g.
"gnome-screensaver-command -d") - Maximum missed (the number of connectivity status that can be 'out of range' before your PC locks - an integer
- Range limit (the maximum range your device can be at before your PC locks) - an integer
- The negative value of the range limit corresponds to the RSSI of your device
These arguments must be in order; if you wish to leave any of these parameters except Bluetooth address as the default (see below), use x as the option value.
You are then free to start Bluetooth Proximity Locker at any time by running:
btpl,btpl -r, orbtpl --run
In order to stop Bluetooth Proximity Locker, run:
btpl -s or btpl --stop
- Bluetooth address has no default - it must be set by running the configuration file
- Scan period:
2.5 - Left range command:
"gnome-screensaver-command -l" - Enters range command:
"gnome-screensaver-command -d" - Maximum missed:
3 - Range limit:
7
In order to edit any configuration options later, from any folder, simply run:
btpl-reconfig [options]
Where [options] is the same as above, except x can be used as a value for the Bluetooth address, and x keeps the currently set value, instead of setting it to the default.