About EAR

Web-based audiometry and speech testing with automatic capture

EAR is a focused web application for conducting pure-tone audiometry and speech-in-noise (WRT) tests directly from the browser. It saves per-frequency thresholds and speech trial results to your database for later review, without changing the test's original flow or logic.

Take Audiometry Take Speech Test

How it works

The app wraps your existing test UI in a small integration layer that listens for the test completion event and writes normalized data to the database. The original test files are not modified in their internal logic — only a single, well-defined save action is used.

🎧

Pure-tone audiometry

Per-frequency thresholds are recorded for left/right ears. User confirms 'YES' during tone presentation.

🗣️

Speech-in-noise (WRT)

Trials record correctness, SNR and response times to estimate speech understanding.

Save flow

Log in (required to save). Guest users can preview but results won't be saved.
Run the test in your browser (headphones recommended).
When the test finishes the page sends the normalized results to the server, which stores meta + child rows.
The page shows the saved Test ID and you can view details in Past tests.

Technical details

Database: ear — normalized schema. Main tables:

tests_meta

One row per completed test. Columns: id, user_id, test_type ('audiometry'|'speech'), ear, device_info, duration_seconds, notes, created_at.

audiometry_results

Stores a row per frequency per ear. Columns: id, users_id (varchar user id), test_id, freq_hz, ear, threshold_db, event_index, created_at.

speech_results

Stores trial-level speech data: trial_index, stimulus, correct, snr, rt_ms, test_id.

Security & privacy

Passwords are stored in plain text by explicit request in this project (not recommended for production). Do not deploy this configuration for public-facing services — use password hashing and HTTPS.

FAQ

Can I preview tests without logging in?: Yes. You can run tests as a guest, but results will not be saved to the database unless you log in first.
How many tests can one user save per day?: Each user can save up to 2 tests per day. This is enforced on the server side.
Can I export my data?: CSV export is not included by default here — I can add an admin/export feature on request.