🎻

ObieWebApp

Β· Oberlin Acoustics Workshop
Tips

Tools for analyzing the vibrational characteristics of violins

This is a modular browser-based toolkit for measuring Violin response. Everything runs locally in your browser β€” no uploads, no server. You need to use Chrome or Edge to access the folder picker and local file saving features.

πŸ“ Data Folder No folder selected

πŸ” Tools β€” v1.1.7 (stable)

πŸ”
Explore

Load, compare, and interpret multiple FRF files. Overlaid plots with smoothing, normalization, band and group averaging, coherence overlays, and per-dataset convolution playback. Print a labeled plot or ask Claude a question, right from the toolbar.

Tool Β· PyScript
πŸ”€
Convolve

Load an FRF CSV or TRF and convolve it with any WAV file. Full complex frequency-domain convolution with min-phase or zero-phase reconstruction. Play and save the result.

Tool Β· PyScript
🎯
Acquire

Impact-hammer FRF acquisition with auto-accept, calibration factors, multi-position templates, an on-screen Agenda checklist, and session notes with camera capture. Settings and templates saved to your Data Folder.

Tool Β· PyScript
πŸ“‘
LiveView

Stand-alone real-time hammer/mic monitor and live FRF estimate β€” the same LiveView as Acquire's "LiveView" button, in its own tab so it can run on a second monitor. Also reachable from inside Acquire.

Tool Β· PyScript

🧬 Beta β€” v1.1.8 (testing)

πŸ”
Explore beta

Load, compare, and interpret multiple FRF files. Overlaid plots with smoothing, normalization, band and group averaging, coherence overlays, and per-dataset convolution playback. Print a labeled plot or ask Claude a question, right from the toolbar.

Beta
🎯
Acquire beta

Impact-hammer FRF acquisition with auto-accept, calibration factors, multi-position templates, an on-screen Agenda checklist, and session notes with camera capture. Settings and templates saved to your Data Folder.

Beta
🌊
Modal Analysis beta

Visualisation and animation of mode shapes from an Acquire modal dataset. Data acquisition has moved to Acquire; Modal Analysis now focuses on loading, inspecting, and animating completed surveys.

Beta
πŸ“
Stencil Builder beta

Design and calibrate node layouts for projector-assisted hammer testing. Drag nodes to position, adjust the projection transform to fit your violin, and save stencils that automatically set positions in Acquire.

Beta
β­•
Circle Fit

Nyquist circle fitting with residual compensation for accelerometer-based modal FRF data. Pin down each mode's natural frequency and damping, then jump straight to that frequency in Modal Analysis.

Beta
πŸŽ™οΈ
Spectrum Monitor new

Live single-channel microphone scope: raw waveform, an averaged magnitude spectrum (block average of the last N ~0.3 s snippets), and an on-demand scrolling spectrogram. Pick channel 1 or 2, pause anytime to zoom in on a Plotly chart.

Beta
πŸ—ΊοΈ
Code Flow Diagrams new

Architecture reference for every tool β€” Mermaid flowcharts and state diagrams of how each tool's code actually works, with real function names. One page linking to a diagram per tool.

Beta

πŸ“š References

πŸ“–
Documentation

How to use Explore, Convolve, and Acquire. Quick-start guide, controls reference, and links to the full technical PDF.

Guide
πŸ—’οΈ
Changelog

Log of fixes and features, per version.

Log
πŸ’»
Source Code

Browse the full source code on GitHub.

GitHub

πŸ§ͺ Experimental

πŸ“Š
Export to MATLAB

Browse your Data Folder, select FRF / AvC / AvR files, and download a .mat file ready to open in MATLAB. Complex FRF data is preserved for AvC files.

Experimental
πŸ”Š
WAV Viewer

Browse your Data Folder for .wav files. View hammer and microphone time-domain signals, trigger markers, and the computed FRF for any recorded capture.

Experimental
πŸ“‹
Experimental Docs

Documentation for experimental tools: Export to MATLAB and WAV Viewer.

Experimental
πŸ’»
Standalone Setup

Three options: web UI via local server with browser caching (once online, then offline forever); fully air-gapped web UI via a one-time asset download script; or native desktop Python tools with no browser at all.

Experimental
πŸ”§
Make Your Own Tool

Build a custom ObieApp tool using Claude Code. A starter prompt gives Claude the project rules, Python modules, and conventions needed to write a complete new tool.

Experimental
πŸ”—
pyDVMA (external)

An independent, browser-based data acquisition & measurement analysis app by Tore Butlin β€” a different take on much of what ObieWebApp does. Not part of this repo; opens on its own site.

External
PyScript version:
Create a new Data Folder

A folder picker will open. To create a new folder inside it: