Bluetooth Proximity Locker

A Python 3 program used to lock your PC when a specified Bluetooth device is a certain distance away.

Installation

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, or
• btpl --run

In order to stop Bluetooth Proximity Locker, run:
btpl -s or btpl --stop

Defaults

• 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

Editing Configuration Later

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.