Bar Minimal Tools

Taskbar minimalista para Windows com monitoramento de hardware em tempo real — Tauri (Rust) como backend nativo para coleta de dados do sistema (CPU, RAM, GPU, Storage, Network) + React (TypeScript + Vite) como frontend com composição de widgets, controles de mídia e gerenciamento de dispositivos de áudio, widget de clima via Open-Meteo API (gratuita, sem API key) com detecção automática de localização por IP, widgets de notas, relógio e status de headset, layout e tema totalmente configuráveis, performance nativa de desktop.

---

Índice

• Sobre o Projeto
• Funcionalidades
• Tecnologias
• Arquitetura
• Começando
  • Pré-requisitos
  • Instalação
  • Uso
• Scripts Disponíveis
• Build
• Testes e Qualidade
• Roadmap
• Contribuindo
• Licença
• Contato

---

Sobre o Projeto

Taskbar minimalista para Windows que substitui ou complementa a barra de tarefas nativa com monitoramento de hardware em tempo real e widgets configuráveis. Combina performance nativa de desktop via Tauri (Rust) com interface moderna via React (TypeScript).

O repositório prioriza:

• Monitoramento de hardware em tempo real — Widgets dedicados para CPU, RAM, GPU, Storage e Network com coleta de dados via backend Rust nativo, sem overhead de runtime interpretado
• Controles de mídia e áudio — Widget de media controls para play/pause/skip e gerenciamento de dispositivos de áudio (seleção de output, volume), integração com APIs nativas do Windows
• Widget de clima — Consumo da Open-Meteo API (gratuita, sem API key necessária) com detecção automática de localização via geolocalização por IP
• Composição de widgets configurável — Layout e tema totalmente customizáveis, com widgets de notas, relógio e status de headset além dos de sistema
• Arquitetura Tauri — Frontend React + Vite para UI e composição de widgets, backend Rust + Tauri para coleta de dados do sistema, integração com OS e APIs nativas Windows
• Qualidade — Unit tests, coverage, lint (ESLint) e type-check (TypeScript), CI via GitHub Actions

---

Funcionalidades

• Monitoramento de hardware — CPU (uso, temperatura), RAM (uso, total/livre), GPU (uso, temperatura, VRAM), Storage (uso por disco), Network (upload/download em tempo real)
• Controles de mídia — Play, pause, skip, previous integrados na taskbar
• Gerenciamento de áudio — Seleção de dispositivo de saída, controle de volume
• Widget de clima — Temperatura, condição, previsão via Open-Meteo API com auto-detecção de localização por IP
• Notas — Widget para anotações rápidas persistentes
• Relógio — Horário com formato configurável
• Status de headset — Indicação de dispositivo de áudio conectado
• Tema e layout — Configuração completa de posicionamento de widgets e tema visual
• Performance nativa — Tauri com footprint mínimo de memória vs Electron

---

Tecnologias

---

Arquitetura

graph TD
    subgraph "Frontend — React + Vite + TypeScript"
        A[Widget Composition Layer]
        A --> B[Hardware Widgets — CPU, RAM, GPU, Storage, Network]
        A --> C[Media Widgets — Controls, Audio Device]
        A --> D[Utility Widgets — Weather, Notes, Clock, Headset]
        A --> E[Theme + Layout Engine]
    end

    subgraph "Backend — Rust + Tauri"
        F[System Data Collector — hardware metrics]
        G[OS Integration — media controls, audio devices]
        H[Native APIs — Windows system calls]
    end

    subgraph "External"
        I[Open-Meteo API — clima gratuito, sem API key]
        J[IP Geolocation — auto-detecção de localização]
    end

    B --> F
    C --> G
    D --> I
    D --> J
    F --> H
    G --> H

Loading

Camadas

Camada	Tecnologia	Responsabilidade
Frontend	React + Vite + TypeScript	Renderização de UI, composição de widgets, interações do usuário, tema e layout
Backend	Rust + Tauri	Coleta de dados do sistema, integração com OS, APIs nativas Windows
External	Open-Meteo API	Dados climáticos gratuitos sem API key

Detalhes completos em docs/ARCHITECTURE.md.

---

Começando

Pré-requisitos

• Node.js 20+
• Rust (stable)
• Windows 10/11 para execução completa do Tauri

Instalação

git clone https://github.com/ESousa97/bar-minimal-tools.git
cd bar-minimal-tools
npm install

Uso

Frontend only (desenvolvimento de widgets sem Tauri):

npm run dev

Aplicação completa (Tauri + React):

npm run tauri dev

---

Scripts Disponíveis

# Desenvolvimento
npm run dev                # Frontend dev server (Vite)
npm run tauri dev          # Aplicação completa (Tauri + React)

# Qualidade
npm test                   # Unit tests
npm run test:coverage      # Coverage report
npm run lint               # ESLint
npm run type-check         # TypeScript type checking

# Build
npm run build              # Frontend build (Vite)
npm run tauri build        # Build completo (instalador Windows)

---

Build

Frontend:

npm run build

Aplicação completa (instalador Windows):

npm run tauri build

---

Testes e Qualidade

# Unit tests
npm test

# Coverage
npm run test:coverage

# Lint
npm run lint

# Type check
npm run type-check

---

Roadmap

Consulte docs/ROADMAP.md para o planejamento completo de features e melhorias.

---

Contribuindo

Contribuições são bem-vindas! Consulte CONTRIBUTING.md para setup, convenções e fluxo de PR.

---

Segurança

Consulte SECURITY.md para política de reporte de vulnerabilidades.

---

Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

MIT License - você pode usar, copiar, modificar e distribuir este código.

---

Contato

Enoque Sousa

---

⬆ Voltar ao topo

Feito com ❤️ por Enoque Sousa