guitar_tap

Guitar Tap는 기타 제작자와 루티어를 위한 데스크톱 애플리케이션으로, 악기, 톤우드 플레이트 또는 브레이스에 대한 간단한 탭을 측정 가능한 음향 데이터로 변환합니다. 탭 후의 짧은 잔향을 포착하고 고해상도 FFT를 실행하여 브레이싱, 질량 분포 및 플레이트 두께를 계획할 때 중요한 공진 피크와 재료 특성을 표시합니다. 측정 방식은 Trevor Gore와 Gerard Gilet의 『Contemporary Acoustic Guitar Design and Build』에 설명된 탭-톤 방법론을 따르며, 기타 제작의 재현성 향상을 목표로 합니다. 이 프로젝트는 무료 오픈소스이며 Python 3과 PySide6로 작성되었고 Windows, macOS, Linux에서 실행됩니다. macOS 및 Windows용 사전 빌드 설치 프로그램은 릴리스 페이지에서 제공되며, macOS 설치 프로그램은 Big Sur(11.0)보다 새로운 시스템이 필요합니다. iPhone, iPad 및 Mac용 네이티브 에디션은 App Store에 출시 예정입니다. 세 가지 측정 모드가 제공됩니다. 기타 모드는 Air/Helmholtz, Top, Back 등 주요 바디 공진을 식별하며 각각 주파수, 피치, Q 계수 및 탭-톤 비율로 표시합니다. 플레이트 모드는 톤우드 블랭크를 측정하여 결 방향 및 결 방향에 수직인 영률, 음속, 비강성, 방사비, 품질 등급 및 Gore 목표 두께를 보고합니다. 브레이스 모드는 브레이스 스트립의 강성, 음속, 비강성 및 품질을 빠르게 단일 탭으로 측정합니다. 추가 기능으로는 탭 감지 시 자동으로 고정되는 실시간 스펙트럼, 다중 탭 평균화, 저장된 측정값의 나란히 비교, 측정값 저장 및 스펙트럼, 이미지, PDF 보고서 내보내기, 측정 마이크용 마이크 보정 지원이 포함됩니다. 소스에서 실행하려면 Python 3.14 이상, Git 및 플랫폼 종속성이 필요합니다: macOS에서는 Homebrew를 통한 PortAudio, Debian/Ubuntu에서는 portaudio19-dev 및 libxcb-cursor-dev, Windows에서는 추가 시스템 패키지가 필요 없습니다. 종속성은 pyproject.toml에 선언되어 있으며 실행 전용, 개발자(pytest, mypy, ruff, weasyprint) 및 패키징(PyInstaller) 엑스트라가 있습니다. 앱은 python -m guitar_tap으로 실행됩니다. 설치 프로그램 빌드는 플랫폼 스크립트를 사용합니다: Linux의 AppImage 도구, Windows의 Inno Setup, macOS의 Apple Developer ID를 통한 코드 서명/공증. soak 스크립트(Tooling/soak.sh)는 빠른 pytest 스위트를 반복 실행하여 비결정적 teardown 또는 가비지 컬렉션 경합을 표면화합니다. README는 soak 통과가 증명이 아닌 확신임을 언급합니다. 시작 시 앱은 저장소의 공개 릴리스에서 최신 버전을 확인하고 닫을 수 있는 배너를 표시합니다. 요청은 개인 데이터, 오디오 또는 측정값을 보내지 않으며 하루에 최대 한 번 실행되고 설정에서 비활성화할 수 있습니다. 전체 사용자 문서는 프로젝트 웹사이트에 호스팅되며 설계 및 로드맵 문서는 별도의 프로젝트 허브 저장소에 있습니다. 소프트웨어는 GPL-3.0 라이선스로, 저작권은 Dolce Sfogato(David Smith)입니다.