O crypto-float-monitor é um aplicativo que desenvolvi em Python 3.10+ utilizando a biblioteca PyQt6, que cria uma janela flutuante exibindo o preço atual do Bitcoin em tempo real. Ele se conecta diretamente ao stream oficial da Binance, garantindo atualização contínua do valor sem a necessidade de recarregar páginas ou interfaces web.

A interface é mínima e discreta, ocupando pouco espaço na tela e permanecendo sempre no topo das outras janelas. Isso permite que o usuário acompanhe o preço enquanto trabalha, joga, estuda ou realiza outras atividades.

Controles rápidos

• Arrastar com o mouse: reposiciona o widget na tela.
• Pressionar `q`: fecha o aplicativo imediatamente.

Simples e direto.

Como instalar e executar

O primeiro passo é clonar o repositório do projeto:

git clone https://github.com/fberbert/crypto-float-monitor.git
cd crypto-float-monitor

Para rodar o aplicativo, basta criar um ambiente virtual e instalar o projeto em modo editável:

python -m venv .venv
source .venv/bin/activate

Instale as dependências definidas no pyproject.toml:

pip install -e .

Execute o aplicativo com:

crypto-float-monitor

Ao ser iniciado pela primeira vez, o programa cria automaticamente um arquivo de configuração em: ${XDG_CONFIG_HOME:-$HOME/.config}/crypto-float-monitor/config.json

O conteúdo padrão é:


Você pode editar esse arquivo para monitorar qualquer outro par disponível na Binance, como ETHUSDT, BNBUSDT, entre outros.

Arquivo AppImage

Ao invés de clonar e instalar o projeto manualmente, você pode baixar a versão pré-compilada em AppImage diretamente da página de releases do GitHub:

• https://github.com/fberbert/crypto-float-monitor/releases

Baixe o arquivo crypto-float-monitor-x.y.z-x86_64.AppImage, dê permissão de execução e rode-o:

chmod +x crypto-float-monitor-*.AppImage
./crypto-float-monitor-*.AppImage

Também é aconselhável mover o arquivo AppImage para um diretório presente no PATH, como /usr/local/bin ou $HOME/.local/bin, para facilitar a execução. Exemplo:

mv crypto-float-monitor-*.AppImage $HOME/.local/bin/crypto-float-monitor

Criando um arquivo .desktop

Para facilitar o lançamento do aplicativo a partir do menu do sistema, você pode criar um arquivo .desktop. Crie o arquivo $HOME/.local/share/applications/crypto-float-monitor.desktop com o seguinte conteúdo:


Obs.: estou considerando que você baixou o AppImage para $HOME/.local/bin/crypto-float-monitor. Se você clonou o repositório e instalou via pip, ajuste o campo Exec para apontar para o script instalado no ambiente virtual ou diretamente no PATH.

Em seguida, para atualizar a lista de aplicativos, execute:

update-desktop-database $HOME/.local/share/applications

Compatibilidade e requisitos

• Python 3.10 ou superior
• Distribuições Linux com ambiente gráfico (X11 ou Wayland)
• Suporte a PyQt6 instalado no sistema

Geração e distribuição como AppImage

Estrutura principal do projeto

• pyproject.toml: define metadados e dependências.
• src/crypto_float_monitor/binance_client.py: cliente WebSocket que assina o stream da Binance.
• src/crypto_float_monitor/widget.py: responsável pela interface flutuante.
• src/crypto_float_monitor/main.py: ponto de entrada (`crypto-float-monitor`).

Conclusão

O crypto-float-monitor é uma ferramenta leve e prática para quem deseja acompanhar o preço do Bitcoin diretamente na área de trabalho, sem distrações e com atualização contínua. Sua configuração simples e a possibilidade de ajustar o par monitorado o tornam útil tanto para traders quanto para curiosos que acompanham o mercado cripto.

Se você utiliza Linux e quer uma forma rápida e eficiente de acompanhar o mercado, vale experimentar.

Contribuições, sugestões e feedbacks são bem-vindos no repositório do projeto no GitHub.

• https://github.com/fberbert/crypto-float-monitor