guitar_tap

Guitar Tap é um aplicativo de desktop para luthiers e construtores de violões que transforma uma simples batida em um instrumento, placa de tonewood ou reforço em dados acústicos mensuráveis. Ele captura o curto ressoar após a batida, executa uma FFT de alta resolução e exibe os picos ressonantes e as propriedades do material que importam ao planejar reforços, distribuição de massa e espessura da placa. A abordagem de medição segue a metodologia de tap-tone descrita em Contemporary Acoustic Guitar Design and Build de Trevor Gore com Gerard Gilet, com o objetivo declarado de melhorar a reprodutibilidade na construção de violões. O projeto é gratuito e de código aberto, escrito em Python 3 com PySide6, e roda em Windows, macOS e Linux. Instaladores pré-compilados para macOS e Windows são oferecidos na página de releases; o instalador do macOS requer um sistema mais novo que Big Sur (11.0). Uma edição nativa para iPhone, iPad e Mac é descrita como futura na App Store. Três modos de medição são fornecidos. O modo Guitar identifica ressonâncias principais do corpo, como Air/Helmholtz, Top, Back e outras, cada uma rotulada com frequência, tom e fator Q, além da proporção de tap-tone. O modo Plate mede uma peça de tonewood, relatando o módulo de Young ao longo e através do grão, velocidade do som, módulo específico, proporção de radiação, uma nota de qualidade e uma espessura alvo de Gore. O modo Brace é uma medição rápida de batida única da rigidez de uma tira de reforço, velocidade do som, módulo específico e qualidade. Capacidades adicionais incluem um espectro em tempo real que congela automaticamente quando uma batida é detectada, média de múltiplas batidas, comparação lado a lado de medições salvas, salvamento de medições e exportação de espectros, imagens e relatórios em PDF, e suporte à calibração de microfone para microfones de medição. Executar a partir do código-fonte requer Python 3.14 ou posterior, Git e dependências de plataforma: PortAudio no macOS via Homebrew, portaudio19-dev e libxcb-cursor-dev no Debian/Ubuntu, e nenhum pacote de sistema extra no Windows. As dependências são declaradas em pyproject.toml, com extras apenas de execução, desenvolvedor (pytest, mypy, ruff, weasyprint) e empacotamento (PyInstaller). O aplicativo inicia com python -m guitar_tap. As compilações do instalador usam scripts de plataforma: ferramentas AppImage no Linux, Inno Setup no Windows e assinatura de código/notarização com um Apple Developer ID no macOS. Um script de soak (Tooling/soak.sh) executa repetidamente a suíte rápida de pytest para revelar corridas não determinísticas de teardown ou coleta de lixo; o README observa que um soak verde é confiança, não prova. Na inicialização, o aplicativo verifica os releases públicos do repositório para uma versão mais recente e mostra um banner dispensável; a solicitação não envia dados pessoais, áudio ou medições, executa no máximo uma vez por dia e pode ser desabilitada nas Configurações. A documentação completa do usuário está hospedada no site do projeto, enquanto os documentos de design e roadmap vivem em um repositório separado do hub do projeto. O software é licenciado sob GPL-3.0, copyright Dolce Sfogato (Trevor Gore).