How akarshjha03/proximitylocksystem works
Project type and purpose
• This is a Python-based CLI application (packaged via setup.py) whose job is to monitor your phone’s Bluetooth presence and lock the desktop when the phone moves out of range.
File structure
• Top-level:
• proximity_lock_system/ – the main Python package
• build/, dist/, *.egg-info – build/artifact outputs created by packaging
• requirements.txt, setup.py – dependency and install metadata
• Inside proximity_lock_system/:
• cli.py – CLI entry point (defines the “proximity-lock” console script)
• config.py – poll intervals, thresholds, pause durations
• core.py – service logic (scanning loop, threshold logic, invoking lock)
• utils.py – platform-agnostic helper functions (Bluetooth scanning, executing lock commands)
README for additional insights
• Dependencies: Python ≥3.8, pybluez, OS-specific lock commands
• Runtime behavior:
• “proximity-lock setup” prepares config (optional)
• “proximity-lock start” launches a loop: scan → compare misses → lock if threshold exceeded
• Platform integration points: Windows, macOS, Linux lock utilities