https://github.com/stethoscope-js/stethoscope
🩺 Track, visualize, and embed your health and life data — location, health, work, play, and more
https://github.com/stethoscope-js/stethoscope
automation clockify data github-actions goodreads google-fit last-fm life oura oura-ring pocket-casts rescue-time spotify time-tracking wakatime
Last synced: 10 days ago
JSON representation
🩺 Track, visualize, and embed your health and life data — location, health, work, play, and more
- Host: GitHub
- URL: https://github.com/stethoscope-js/stethoscope
- Owner: stethoscope-js
- License: mit
- Created: 2020-08-14T07:29:48.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-04-02T01:45:19.000Z (14 days ago)
- Last Synced: 2025-04-02T12:18:48.979Z (13 days ago)
- Topics: automation, clockify, data, github-actions, goodreads, google-fit, last-fm, life, oura, oura-ring, pocket-casts, rescue-time, spotify, time-tracking, wakatime
- Homepage: https://stethoscope.js.org
- Size: 78.1 MB
- Stars: 123
- Watchers: 5
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- project-awesome - stethoscope-js/stethoscope - 🩺 Track, visualize, and embed your health and life data — location, health, work, play, and more (Others)
README
# 
[](https://github.com/stethoscope-js/stethoscope/actions?query=workflow%3A%22Stethoscope+CI%22)
[](https://github.com/stethoscope-js/stethoscope/actions?query=workflow%3A%22Update+Template+CI%22)
Track, visualize, and embed all your health and life data — location, health, work, play, and more.
[**To get started, visit stethoscope.js.org →**](https://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
| Service | API | Sample data | Docs |
| ------- | --- | ----------- | ---- |
| 
Spotify | [`src/api/spotify.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/spotify.ts) | [View data](./data/spotify-music) | [View docs →](https://stethoscope.js.org/docs/integrations/spotify) |
| 
Last.fm | [`src/api/last-fm.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/last-fm.ts) | [View data](./data/last-fm-music) | [View docs →](https://stethoscope.js.org/docs/integrations/lastfm) |
| 
Rescue Time | [`src/api/rescuetime.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/rescuetime.ts) | [View data](./data/rescuetime-time-tracking) | [View docs →](https://stethoscope.js.org/docs/integrations/rescuetime) |
| 
Wakatime | [`src/api/wakatime.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/wakatime.ts) | [View data](./data/wakatime-time-tracking) | [View docs →](https://stethoscope.js.org/docs/integrations/wakatime) |
| 
Pocket Casts | [`src/api/pocket-casts.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/pocket-casts.ts) | [View data](./data/pocket-casts-podcasts) | [View docs →](https://stethoscope.js.org/docs/integrations/pocket-casts) |
| 
Goodreads | [`src/api/goodreads.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/goodreads.ts) | [View data](./goodreads-books) | [View docs →](https://stethoscope.js.org/docs/integrations/goodreads) |
| 
Clockify | [`src/api/clockify.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/clockify.ts) | [View data](./data/clockify-time-tracking) | [View docs →](https://stethoscope.js.org/docs/integrations/clockify) |
| 
Google Fit | [`src/api/google-fit.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/google-fit.ts) | [View data](./data) | [View docs →](https://stethoscope.js.org/docs/integrations/google-fit) |
| 
Oura Ring | [`src/api/oura-ring.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/oura-ring.ts) | [View data](./data/oura-activity) | [View docs →](https://stethoscope.js.org/docs/integrations/oura-ring) |
| 
Twitter | [`src/api/twitter.ts`](https://github.com/stethoscope-js/integrations/tree/master/src/api/twitter.ts) | [View data](./data/twitter-tweets) | [View docs →](https://stethoscope.js.org/docs/integrations/twitter) |
## 🌱 [Getting started](https://stethoscope.js.org/docs/)
1. Create a repository [using this template](https://github.com/stethoscope-js/stethoscope/generate)
2. Delete the [`./data`](./data) directory
3. Update the configuration in [`.stethoscoperc.yml`](./.stethoscoperc.yml)
4. Add the required GitHub repository secrets
5. [Enable publishing](https://docs.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site) the `master` branch
## 📝 Documentation
**Visit our docs website: https://stethoscope.js.org**
## 🛠️ Configuration
A [`.stethoscoperc.yml`](./.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](https://anandchowdhary.com)'s RescueTime weekly overview URL, fetched from [AnandChowdhary/life](https://github.com/AnandChowdhary/life):
[](https://stethoscope.js.org/embed/?repo=AnandChowdhary%2Flife&api=rescuetime-time-tracking&latest=top-overview.weeks)
Learn how to make your own embeds on https://stethoscope.js.org/docs/embed.
## 📄 License
- Code: [MIT](./LICENSE) © [Anand Chowdhary](https://anandchowdhary.com)
- Data in [`./data`](./data): [Open Database License](https://opendatacommons.org/licenses/odbl/1-0/) © [Anand Chowdhary](https://anandchowdhary.com)