ProDeck — agente que executa ações no PC a partir do deck no celular
Project description
ProDeck Agent
Transforme o celular (ou um tablet velho) num painel de botões touch que controla o seu PC pela rede Wi-Fi: abrir projetos no editor, pastas, URLs, disparar macros, atalhos de teclado, controlar mídia — com foco em produtividade de desenvolvedor, não em streaming.
Sem app de loja: o agente roda no PC e serve a própria PWA. Você escaneia um QR no celular e está usando — o endereço já leva o token, não precisa digitar nada.
Instalação
uv tool install prodeck-agent # ou: pipx install prodeck-agent
prodeck-agent # imprime o QR + URLs de pareamento no terminal
No celular (mesma rede do PC), escaneie o QR. Para abrir em tela cheia (PWA instalada), rode prodeck-agent --tls e siga o assistente de pareamento.
Comandos
| Comando | O que faz |
|---|---|
prodeck-agent |
roda em primeiro plano (QR e URLs no terminal) |
prodeck-agent --tls |
HTTPS + assistente de pareamento por QR (instala a PWA em tela cheia) |
prodeck-agent --install-service |
autostart via systemd de usuário (acrescente --tls p/ HTTPS no boot) |
prodeck-agent --reset-pairing |
gera token novo e esquece os dispositivos pareados |
Configure os botões pelo próprio celular (toque no lápis), pelo navegador do PC, ou editando ~/.config/prodeck/profiles.json (sincroniza sozinho). O editor tem seletor de apps instalados (já traz o ícone do programa), atalhos prontos detectados na máquina (mutar som/mic, volume, bloquear tela) e botão "Testar" que roda a ação sem salvar. Tipos de ação: programa, pasta, URL, atalho de teclado, texto, shell (opt-in) e macro. Botões podem refletir estado real do PC (mic/áudio mutado).
Requisitos
- Python ≥ 3.12, Linux. A ação de atalho de teclado (
hotkey) usa X11; as demais funcionam também em Wayland. - Atalhos de mídia/bloquear usam o que a máquina tiver:
wpctl(PipeWire) oupactl(PulseAudio) para áudio;loginctl/xdg-screensaverpara bloquear. Detectados automaticamente.
Documentação e roadmap
Código, arquitetura, plano de desenvolvimento e guia de solução de problemas: https://github.com/tadash82/prodeck
Licença: MIT.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file prodeck_agent-1.1.0.tar.gz.
File metadata
- Download URL: prodeck_agent-1.1.0.tar.gz
- Upload date:
- Size: 259.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
353a52155bc5e60c3e9d1222bfcdc692265e8d8948bbb043b730cdec536eb6e7
|
|
| MD5 |
d29e23e3b72aa4cc3df1f480ea97ca34
|
|
| BLAKE2b-256 |
ee9c7c322d43c4e1d3b44334323113f5104399d96475156ce5df26245faac27f
|
File details
Details for the file prodeck_agent-1.1.0-py3-none-any.whl.
File metadata
- Download URL: prodeck_agent-1.1.0-py3-none-any.whl
- Upload date:
- Size: 187.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1ae3cd31d444b517e334adc8a4758f04c4e2006c7e1c5912f13f96b86a2908a5
|
|
| MD5 |
621e6453413c597101dd6b0f4c616bc5
|
|
| BLAKE2b-256 |
b0ce3f590f74f3340f2fa15c772e00311620c7595603ba1bac8a939a9b1c4b11
|
