Meshyface

Meshyface é um painel (dashboard) focado em chat para Meshtastic que funciona como um único serviço Python e serve uma interface web de página única via HTTP.

Superfície Atual do Aplicativo

A UI atual expõe:

• Chat mais conversas diretas entre pares
• Workspace de rede para mapa, visão geral, links, rotas, sensores, rankings Top 10, detalhes de nós e histórico sob demanda
• Workspace de console para saída ao vivo de pacotes/logs
• Workspace de aplicativos com uma aba Jogos e uma aba Arquivos quando a transferência de arquivos está ativada
• Workspace de configurações com painéis de rádio, dispositivo, conectividade, localização, canais, tickers, listas, aparência e sobre
• Histórico baseado em SQLite, busca, rollups, persistência de tema e persistência de regras de telemetria personalizadas

Workspace de Console

O workspace de console é uma superfície de controle estilo terminal para tráfego de pacotes, busca de histórico e comandos utilitários da malha.

• Digite um nome de comando para abrir sugestões de autocomplete. Use Tab ou Enter para aceitar, ArrowRight para aceitar o sufixo fantasma, e ArrowUp / ArrowDown para navegar no popup.
• Comandos que aceitam um nó alvo mostram sugestões de nós completas com nome, ID, emoji, tag, status, hops, GPS, último estado ouvido, portas e número do nó. Texto normal filtra por nomes e tags de nós; ! filtra por ID do nó.
• live transmite o tráfego de pacotes até Ctrl+C ou q. Use live grep <texto>, live rg <texto>, live filter=<texto>, ou apenas live <texto> para transmitir apenas grupos de pacotes ao vivo correspondentes. Filtros de camada e verbosidade ainda se aplicam, por exemplo live rg TEXT_MESSAGE_APP -vv --layer=2.
• grep <texto> e rg <texto> buscam no histórico retido de pacotes/chat com janelas de contexto, limites, filtros de fonte de pacote/chat e filtros de escopo de resumo/pacote.
• /search <texto> filtra a saída visível do console a partir do prompt sem iniciar uma busca no histórico retido.

Screenshots (Capturas de Tela)

Mapa de rede ao vivo

Visualização do mapa com localizações de nós, links, caminhos comuns, clusters e mapa de calor de sinal.

Visão geral da rede

Visualização do histórico para contagens de nós, status online, novos nós e relatórios de posição.

Topologia de links

Visualização da topologia mostrando links observados a partir do nó raiz selecionado.

Rastreio de rota

Visualização de rastreio para uma origem, destino, links próximos e detalhes de pacote por hop.

Histórico de sensores

Gráfico de telemetria comparando o histórico de sensores entre múltiplos nós.

Cartões de status

Cartões principais para atividade de rádio, contagens de nós, pacotes, links, bateria e uso de canal.

Personalização de tema

Os temas podem remodelar o painel completo com cores personalizadas, gradientes, transparência, desfoque, fontes, partículas ou um fundo de mapa ao vivo. Estas paletas de exemplo são temas personalizados; selecione qualquer pré-visualização para abrir sua captura de tela em resolução total.

Signal Green	Neon Magenta	Aurora Relay

Aparências compartilhadas de nós

Nós Meshyface podem compartilhar pacotes de aparência compactos contendo uma receita de tema de nó e um fantasma ou marca d'água opcional. Configure e visualize seu nó em Settings > Appearance > Node Appearance, ative Share node appearance, e depois use Broadcast appearance para publicá-lo.

• Pacotes de aparência usam o canal de envio do perfil configurado e herdam a configuração de hop-limit do rádio; Meshyface não impõe um limite de hop separado.
• Aparências recebidas podem estilizar identidades de nós no chat, listas, detalhes de nós, mapas, gráficos, sensores e tickers sem substituir o tema do próprio painel receptor.
• Desativar Share node appearance desabilita ambos os lados da funcionalidade. Interrompe transmissões e desvia o caminho de recepção do perfil antes que cargas de aparência recebidas sejam decodificadas, armazenadas em cache ou persistidas; aparências compartilhadas em cache são limpas e nenhuma aparência recebida é renderizada.
• Quando o histórico está ativado, os perfis recebidos e a preferência de compartilhamento local persistem no banco de dados SQLite de histórico.
• Aparências compartilhadas são metadados cosméticos. Uma aparência recebida não altera as configurações de rádio, canais ou o tema do pacote salvo do painel.

Arquitetura do Sistema

flowchart LR
  Browser["Browser<br/>single-page UI"]
  CDN["Vendored browser assets<br/>Leaflet + leaflet.heat + particles.js"]
  Tiles["Basemap provider<br/>OpenStreetMap tile service"]
  Server["ThreadingHTTPServer<br/>HTML shell + JSON API"]
  Assets["Python template assembly<br/>meshdash/html* + meshdash/assets/*"]
  State["State loaders<br/>live snapshot + history readers"]
  Services["Write services<br/>chat, settings, tools, games, optional files"]
  Tracker["DashboardTracker<br/>live receive path + in-memory buffers"]
  History["HistoryStore / SQLite (WAL)<br/>chat, packets, rollups, settings"]
  Radio["Meshtastic interface<br/>serial or TCP"]
  Mesh["Meshtastic radio / mesh"]
  Atlas["Bundled offline atlas<br/>reference basemap fallback"]

  Browser -->|GET /| Server
  Browser -->|GET /api/*| Server
  Browser -->|POST write APIs| Server
  Browser --> CDN
  Browser --> Tiles
  Browser -->|fallback basemap data| Atlas
  Server --> Assets
  Server --> State
  Server --> Services
  State <--> Tracker
  State <--> History
  Services <--> History
  Services <--> Radio
  Radio <--> Mesh
  Radio -->|receive callbacks| Tracker

Instalação

Comece com pré-requisitos e dependências, depois escolha um caminho de instalação: