Stethoscope
🩺 Track, visualize, and embed your health and life data — location, health, work, play, and more
Install / Use
/learn @stethoscope-js/StethoscopeREADME
<a href="https://stethoscope.js.org"><img alt="Stethoscope" src="https://stethoscope.js.org/branding/screenshot.jpeg"></a>
Track, visualize, and embed all your health and life data — location, health, work, play, and more.
To get started, visit stethoscope.js.org →
🌟 Features
- Track data from anywhere (health, music, time tracking, etc.)
- Generate easy-to-consume API endpoints for your data
- Daily, weekly, monthly, and yearly graphs with easy embedding
Supported services
<!-- prettier-ignore-start -->| Service | API | Sample data | Docs |
| ------- | --- | ----------- | ---- |
| <img alt="" src="https://cdn.worldvectorlogo.com/logos/spotify-2.svg" width="12"> Spotify | src/api/spotify.ts | View data | View docs → |
| <img alt="" src="https://cdn2.iconfinder.com/data/icons/social-icon-3/512/social_style_3_lastfm-512.png" width="12"> Last.fm | src/api/last-fm.ts | View data | View docs → |
| <img alt="" src="https://images.weserv.nl/?url=https://encrypted-tbn0.gstatic.com/images?q=tbn%3AANd9GcS5cnw0MQF7TnpSzlRTlIC6z4EHDEPP3B8qBw&usqp=CAU&w=64&h=64&fit=cover" width="12"> Rescue Time | src/api/rescuetime.ts | View data | View docs → |
| <img alt="" src="https://cdn.worldvectorlogo.com/logos/wakatime.svg" width="12"> Wakatime | src/api/wakatime.ts | View data | View docs → |
| <img alt="" src="https://images.weserv.nl/?url=https://lh3.googleusercontent.com/23K9TDTOdlo57Pi9JvNtPc9K-utruK6jQEpQGD_E4QBLRJYRAgLcC7gF2Rd_0T1qhLLS&w=64&h=64&fit=cover&mask=circle" width="12"> Pocket Casts | src/api/pocket-casts.ts | View data | View docs → |
| <img alt="" src="https://images.weserv.nl/?url=https://icon-library.com/images/goodreads-icon/goodreads-icon-14.jpg&w=64&h=64&fit=cover&mask=circle" width="12"> Goodreads | src/api/goodreads.ts | View data | View docs → |
| <img alt="" src="https://clockify.me/assets/images/brand-assets/clockify-icon.svg" width="12"> Clockify | src/api/clockify.ts | View data | View docs → |
| <img alt="" src="https://www.gstatic.com/images/branding/product/1x/gfit_512dp.png" width="12"> Google Fit | src/api/google-fit.ts | View data | View docs → |
| <img alt="" src="https://images.weserv.nl/?url=https://static1.ouraring.com/images/symbol-oura-large-white.svg&w=64&h=64&fit=cover&mask=circle" width="12"> Oura Ring | src/api/oura-ring.ts | View data | View docs → |
| <img alt="" src="https://cdn.worldvectorlogo.com/logos/twitter-6.svg" width="12"> Twitter | src/api/twitter.ts | View data | View docs → |
🌱 Getting started
- Create a repository using this template
- Delete the
./datadirectory - Update the configuration in
.stethoscoperc.yml - Add the required GitHub repository secrets
- Enable publishing the
masterbranch
📝 Documentation
Visit our docs website: https://stethoscope.js.org
🛠️ Configuration
A .stethoscoperc.yml file is used for configuration. For more information, see https://stethoscope.js.org/docs/configuration.
📊 Example
This is a real-time screenshot of Anand Chowdhary's RescueTime weekly overview URL, fetched from AnandChowdhary/life:
Learn how to make your own embeds on https://stethoscope.js.org/docs/embed.
📄 License
- Code: MIT © Anand Chowdhary
- Data in
./data: Open Database License © Anand Chowdhary
Security Score
Audited on Mar 30, 2026
