{"id":18870250,"url":"https://github.com/thor77/blueproximity","last_synced_at":"2025-04-14T15:20:59.737Z","repository":{"id":81628354,"uuid":"65564514","full_name":"Thor77/Blueproximity","owner":"Thor77","description":"Run a command once a bluetooth device is in/out of a range","archived":false,"fork":false,"pushed_at":"2019-09-01T11:32:01.000Z","size":1152,"stargazers_count":66,"open_issues_count":36,"forks_count":16,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-03-28T04:11:21.854Z","etag":null,"topics":["bluetooth","desktop","distance"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Thor77.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2016-08-12T15:44:17.000Z","updated_at":"2024-06-02T21:29:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"30faacf3-ce25-434b-a158-b320609fc518","html_url":"https://github.com/Thor77/Blueproximity","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thor77%2FBlueproximity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thor77%2FBlueproximity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thor77%2FBlueproximity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thor77%2FBlueproximity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Thor77","download_url":"https://codeload.github.com/Thor77/Blueproximity/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248904622,"owners_count":21180836,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bluetooth","desktop","distance"],"created_at":"2024-11-08T05:19:29.012Z","updated_at":"2025-04-14T15:20:59.711Z","avatar_url":"https://github.com/Thor77.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Blueproximity [![Documentation Status](https://readthedocs.org/projects/blueproximity/badge/?version=latest)](http://blueproximity.readthedocs.io/en/latest/?badge=latest) [![Build Status](https://travis-ci.org/Thor77/Blueproximity.svg?branch=master)](https://travis-ci.org/Thor77/Blueproximity)\n=============\n\n**Currently only [CLI](#CLI) usage is in a working state**\n**You have to pair your bluetooth device manually and specifc it's MAC-address as an argument**\n\n[TODOs until reaching usable state](https://github.com/Thor77/Blueproximity/milestone/1)\n\nThis software helps you add a little more security to your\ndesktop. It does so by detecting one of your bluetooth devices,\nmost likely your mobile phone, and keeping track of its distance.\n\nIf you move away from your computer and the distance is above\na certain level (no measurement in meters is possible) for a\ngiven time, it automatically locks your desktop\n(or starts any other shell command you want).\nSee end of this file for interesting commands.\n\nOnce away your computer awaits its master back - if you are\nnearer than a given level for a set time your computer unlocks\nmagically without any interaction\n(or starts any other shell command you want).\n\nSee the doc/ directory or the website which both contain\na manual with screenshots.\n\nPlease note that there might still some bugs, use the sourceforge\nsite to keep track of them or tell me about new ones not mentioned\nthere.\nPlease read the whole manual - it's short enough, hopefully easy\nunderstandable and hey - it even got some pretty pictures in there\ntoo :-)\n\n## Contributors\n* Tobias Jakobs (GUI optimizations)\n* Zsolt Mazolt (GUI and KDE stuff)\n* christoss (Slovene translation)\n* eljak (Arabic translation)\n* byMeanMachine (Polish translation)\n\n## Interesting commands\n* Un-/Locking gnome-screenserver\n    * `gnome-screensaver-command -l`\n    * `gnome-screensaver-command -d`\n* Telling GAIM your status\n  * `gaim-remote \"irc:setstatus?status=away\u0026message=BlueProximity thinks I am away\"`\n  * `gaim-remote \"irc:setstatus?status=available\"`\n\n## CLI\n```\nusage: blueproximity [-h] [--gui] [-c CONFIG] -m MAC\n\nUnlock your computer as soon as a bluetooth-device is in range\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --gui                 Start GUI\n  -c CONFIG, --config CONFIG\n                        Path to configfile\n  -m MAC, --mac MAC     Provide mac of target device\n```\n\nExample `config.ini`\n```\n[Lock]\ndistance = 7\nduration = 7\ncommand = gnome-screensaver-command -l\n\n[Unlock]\ndistance = 4\nduration = 1\ncommand = gnome-screensaver-command -d\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthor77%2Fblueproximity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthor77%2Fblueproximity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthor77%2Fblueproximity/lists"}