Repolode
Akarshjha03

Akarshjha03/ProximityLockSystem

Uma CLI em Python que bloqueia automaticamente o computador quando o celular ou smartwatch pareado via Bluetooth sai do alcance.

Estrelas
146
Forks
12
Issues abertas
0
Último commit
mês passado

O que é?

O Proximity Lock System é uma ferramenta de linha de comando que monitora dispositivos Bluetooth próximos e bloqueia o computador quando não consegue mais detectar um dispositivo escolhido por você, como um celular ou smartwatch. Ela é voltada a quem quer que a tela seja bloqueada automaticamente ao se afastar da mesa.

Depois que você escolhe o dispositivo durante a configuração, a ferramenta procura por ele periodicamente. Ela contabiliza as tentativas consecutivas sem encontrá-lo e executa o comando de bloqueio do sistema operacional quando um limite configurável é atingido. O intervalo entre verificações, a duração da busca, a pausa para desbloqueio e o limite de tentativas são definidos em um arquivo de configuração.

Os comandos de bloqueio variam conforme a plataforma: rundll32 LockWorkStation no Windows, CGSession no macOS e gnome-screensaver-command no Linux, com instruções para substituí-los por alternativas em outros ambientes de desktop. A instalação é feita pelo PyPI, e a ferramenta depende do pybluez.

Recursos principais

  • 01Monitora um dispositivo Bluetooth escolhido e detecta quando ele sai do alcance.
  • 02Bloqueia a sessão após um número configurável de verificações consecutivas sem encontrar o dispositivo.
  • 03Pausa as verificações por um período definido após o bloqueio ou o desbloqueio manual.
  • 04Compatível com Windows, macOS e Linux, usando comandos de bloqueio específicos para cada plataforma.
  • 05Pode ser instalado pelo PyPI e configurado por meio de um módulo de configuração.

Casos de uso

  • Bloquear automaticamente um computador de escritório ao se afastar com o celular.
  • Adicionar um bloqueio simples baseado em presença a um computador compartilhado em casa.
  • Experimentar a detecção de proximidade por Bluetooth em Python.

Início rápido

  1. 1

    Instalar o pybluez

    pip install pybluez
  2. 2

    Instalar o aplicativo

    pip install proximity-lock-system
  3. 3

    Configurar o serviço e escolher o celular

    proximity-lock setup
  4. 4

    Iniciar o monitoramento

    proximity-lock start

Antes de usar

  • O README recomenda testá-lo primeiro em uma máquina virtual, pois ele bloqueia o sistema real.
  • Os comandos de bloqueio variam conforme a plataforma; no Linux ou macOS, talvez seja necessário editar core.py para adaptá-lo ao seu ambiente de desktop.
  • É necessário ter um adaptador Bluetooth funcionando e Python 3.8 ou superior.
  • Licenciado sob AGPL-3.0, uma licença copyleft que exige o compartilhamento do código-fonte modificado quando o software é executado como serviço de rede.

Tópicos

Perguntas frequentes

O que é ProximityLockSystem?
Uma CLI em Python que bloqueia automaticamente o computador quando o celular ou smartwatch pareado via Bluetooth sai do alcance. O Proximity Lock System é uma ferramenta de linha de comando que monitora dispositivos Bluetooth próximos e bloqueia o computador quando não consegue mais detectar um dispositivo escolhido por você, como um celular ou smartwatch. Ela é voltada a quem quer que a tela seja bloqueada automaticamente ao se afastar da mesa.
ProximityLockSystem é gratuito? Qual é a licença?
ProximityLockSystem é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
ProximityLockSystem ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de ProximityLockSystem foi em 10 de set. de 2026.
Para que posso usar ProximityLockSystem?
Bloquear automaticamente um computador de escritório ao se afastar com o celular. Adicionar um bloqueio simples baseado em presença a um computador compartilhado em casa. Experimentar a detecção de proximidade por Bluetooth em Python.
Como instalar ProximityLockSystem?
Instalar o pybluez: pip install pybluez Instalar o aplicativo: pip install proximity-lock-system Configurar o serviço e escolher o celular: proximity-lock setup Iniciar o monitoramento: proximity-lock start
Onde consigo ProximityLockSystem?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Akarshjha03/ProximityLockSystem

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados