🎻

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.7 (testing)

πŸ”
Explore beta

New: hovering a dataset now shows that instrument's saved notes right in the sidebar. Also fixed the normalization dropdown not always starting on "As measured" on reload.

Beta
🎯
Acquire beta

Now also collects modal data: configurable response label (acceleration, velocity, displacement) and stencil-driven node positions for roving-hammer modal surveys.

Beta
🌊
Modal Analysis updated

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 new

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
πŸ“‘
LiveView new

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.

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
PyScript version:
Create a new Data Folder

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