Free, open-source hearing health toolkit. No ads, no tracking, no accounts required.
- 🚀 Product Hunt - https://www.producthunt.com/products/hearwell-free-hearing-health-tools
- 🔥 Hacker News - Coming soon!
- 📰 Dev.to - Coming soon!
I've been living with chronic tinnitus for 8 years. During this time, I've discovered that the tools needed to manage tinnitus and monitor hearing health are either:
- Locked behind expensive paywalls ($50-200 per app)
- Require creating accounts and sharing personal data
- Not accessible in multiple languages
- Lack proper scientific backing
HearWell exists to fix this. It's completely free, runs entirely in your browser, and respects your privacy. No data collection, no accounts, no barriers—just tools that help.
Professional-grade hearing test with real-time audiogram visualization. Test frequencies from 250Hz to 10kHz across 12 volume levels. Export comprehensive CSV reports for your records or to share with your audiologist.
Pinpoint the exact frequency of your tinnitus (50Hz - 20kHz) using multiple waveforms. Essential first step for personalized sound therapy.
Advanced neuromodulation therapy using:
- Amplitude Modulation (AM) - Varying intensity
- Frequency Modulation (FM) - Wobbling tones
- Coordinated Reset (CR) - Randomized sequences to prevent neural adaptation
- Background Sounds - Nature sounds (rain, ocean, birds, cicadas)
- Colored Noise - White, pink, brown, violet, blue, grey with 8-band EQ
- Notched Noise - Advanced therapy with 10-band EQ and precise frequency control
English, Spanish, French, German, Portuguese, Turkish, Chinese, Hindi, Japanese
🌐 Use it online: hearwell.life - No installation needed!
💻 Run locally:
git clone https://github.com/rebelias/Hearwell.git
cd Hearwell
npm install
npm run devOpen http://localhost:5000 in your browser.
- ✅ 100% Client-Side - All processing happens in your browser
- ✅ No Data Collection - Zero tracking, zero analytics
- ✅ No Accounts / No Backend - Static site; nothing to sign up for
- ✅ No Third-Party Scripts - Your data stays yours (no analytics/ads)
- ✅ GDPR Compliant - Privacy by design
Your hearing test results never leave your device unless you choose to export them.
- LocalStorage only (on your device) for:
- Disclaimer acceptance (
hearwell-disclaimer-accepted) - Calibration settings (
audiometer-calibration,audiometer-calibrated) - UI preferences (theme, language, and some tool settings)
- Optional local error logs for debugging (
hearwell_errors)
- Disclaimer acceptance (
- Google Fonts are loaded from
fonts.googleapis.com/fonts.gstatic.comfor typography. This makes a network request to Google’s CDN (no analytics scripts are used).
- Frontend: React 18 + TypeScript 5.6 + Vite 5
- Styling: Tailwind CSS + Shadcn/ui
- Audio: Web Audio API (native browser API)
- i18n: react-i18next (9 languages)
- Testing: Vitest + Playwright
- CI/CD: GitHub Actions + Cloudflare Pages
- 🩺 For Individuals: Monitor your hearing health, manage tinnitus
- 🏥 For Clinics: Free screening tool for resource-limited settings
- 🎓 For Students: Learn about audiology and Web Audio API
- 🔬 For Researchers: Collect hearing data in studies (with consent)
- 🌍 For Communities: Accessible hearing health in any language
- Technical Documentation - 1400+ line architecture guide
- Design Guidelines - UI/UX specifications
- Contributing Guide - How to contribute
We welcome contributions! Whether you're fixing bugs, adding features, or translating to new languages:
- Fork the repo
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Ideas for contributions:
- 🌐 Add translations (more languages needed!)
- 🎨 Improve UI/UX
- 🐛 Fix bugs
- 📚 Improve documentation
- ✨ Add new therapeutic sound modes
npm run test # Unit tests
npm run test:coverage # Coverage report
npm run test:e2e # End-to-end tests (requires: npx playwright install)
npm run lint # LintingTarget: 80%+ code coverage
| Browser | Status |
|---|---|
| Chrome/Edge | ✅ Full support |
| Firefox | ✅ Full support |
| Safari | ✅ Full support* |
| Mobile | ✅ Supported* |
*May require user interaction to start audio (browser security policy)
npm run build # Creates optimized production build
npm start # Serves production buildDeploy to any static hosting (Cloudflare Pages, Vercel, Netlify, GitHub Pages).
HearWell is an educational tool, NOT a medical device.
- ❌ Not a replacement for professional audiological evaluation
- ❌ Not FDA approved or medically certified
- ❌ Not for diagnosis or treatment decisions
Always consult qualified healthcare professionals for:
- Professional hearing assessments
- Medical diagnosis
- Treatment recommendations
- Any concerns about your hearing health
Audio Safety: Use headphones at safe volumes. Stop immediately if you experience discomfort.
By using HearWell, you agree to use it at your own risk. See full LICENSE for details.
Built with love by someone who knows what it's like to live with tinnitus.
Special thanks to:
- The open-source community
- Web Audio API contributors
- Everyone who suggested features and reported bugs
- 🐛 Bug Reports: Open an issue
- 💡 Feature Requests: Start a discussion
- 💬 Share Your Experience: Leave feedback
- 🌟 Star the repo if HearWell helps you!
- 💬 Spread the word to anyone who might benefit
For medical questions, please consult a healthcare professional.
- ⭐ GitHub Stars:
- 🍴 Forks:
- 🌍 Available in 9 languages
- 🎯 100% privacy-focused - No tracking, no data collection
- 🌐 Live Application: hearwell.life
- 📦 GitHub Repository: github.com/rebelias/Hearwell
- 💬 Discussions: GitHub Discussions
- 🐛 Bug Reports: GitHub Issues
- 🔒 Security Policy: SECURITY.md
- 🤝 Contributing Guide: CONTRIBUTING.md
For SEO and discoverability:
tinnitus relief tools, online hearing test, free audiometer, tinnitus frequency finder, sound therapy, hearing loss test, notched noise therapy, coordinated reset, tinnitus management, hearing health, web-based audiometer, browser hearing test, tinnitus masking, acoustic neuromodulation, hearing assessment, tinnitus treatment, sound masking, white noise generator, pink noise, brown noise, hearing test app, audiogram online, pure tone audiometry, hearing conservation, tinnitus therapy, open source medical tools
MIT License - see LICENSE file for details.
TL;DR: Free to use, modify, and distribute. Just don't sue us. 😊
- Add more therapeutic sound modes
- Implement frequency-specific volume testing
- Add data export options (JSON, PDF)
- Create mobile apps (React Native)
- Add more languages (Arabic, Korean, Italian, etc.)
- Implement sound quality presets
- Add calibration for different headphone types
Want to help? Pick an item and open a PR!
Made with ❤️ by someone who lives with tinnitus, for everyone who does.