# Life Tracker plugin for Obsidian
Capture and visualize the data that matters in your life. This Obsidian plugin adds a "Life Tracker" [[Obsidian Bases|Obsidian Base]] type that transforms your tracked data into beautiful visualizations.
## Features
### Visualizations
- **13 visualization types**: Heatmap, Line, Bar, Area, Pie, Doughnut, Radar, Polar Area, Scatter, Bubble, Tag Cloud, Timeline, Progress Ring
- **GitHub-style heatmaps** with 5 color schemes (green, blue, purple, orange, red)
- **Animated charts** with configurable duration and play/pause controls
- **Interactive elements**: click chart elements to open source notes, hover for detailed tooltips
- **Goals and targets**: set a goal per visualization ("3 days a week", "150 reps a week", "at most 80 kg") and track progress against it, with the target drawn as a reference line on cartesian charts
- **Progress rings**: circular progress toward a goal for the period you are currently in, with hit rate, streaks and a bar per recent period
### Customization
- **Per-view settings**: time granularity (daily to yearly), date anchor property, layout options
- **Grid layout controls**: adjustable columns (1-6) and card height
- **Visualization presets**: auto-apply settings to properties by name pattern
- **Scale configuration**: auto-detect or manual min/max for numeric visualizations
- **Chart options**: toggle legend, grid lines, and more
### User Experience
- **Context menu**: right-click any card to change visualization, configure scale, maximize, or reset
- **Maximize mode**: expand any visualization to full view (press Escape to exit)
- **Persistent settings**: grid layout and card configurations saved per view
- **Empty states**: helpful messages when data is missing or misconfigured
- **High contrast mode**: opt-in maximum-contrast rendering for users who need high visibility
- **Touch-friendly**: on mobile, tapping a chart point or heatmap cell inspects it and a second tap opens the note
## Video

## Screenshots
### Dashboard with multiple visualizations
![[Life Tracker plugin for Obsidian - visualizations.png]]
With trends:
![[Life Tracker plugin for Obsidian - with trends.png]]
View your tracked data with different visualization types: area charts, heatmaps, bar charts, and line charts in a grid layout.
### Select visualization type
![[Life Tracker plugin for Obsidian - select type.png]]
Choose from 13 visualization types when configuring a new property: Heatmap, Bar Chart, Line Chart, Area Chart, Pie Chart, Doughnut Chart, Radar Chart, Polar Area Chart, Scatter Chart, Bubble Chart, Tag Cloud, Timeline, and Progress Ring.
### Customize Time Granularity
![[Life Tracker plugin for Obsidian - customize time granularity.png]]
Set the time granularity for your visualizations: Daily, Weekly, Monthly, Quarterly, or Yearly.
### Configure View Settings
![[Life Tracker plugin for Obsidian - configure view settings.png]]
Adjust layout options including number of columns, empty date display, default chart type, and legend visibility.
### Right-click Context Menu
![[Life Tracker plugin for Obsidian - right click context menu.png]]
Right-click any card to change visualization type, configure scale (auto-detect or preset ranges like 0-1, 0-5, 0-10, 0-100), maximize, or reset configuration.
### Goals and Progress Rings
![[Life Tracker plugin for Obsidian - progress ring.png]]
Set a goal on any property and track it with a progress ring. The ring shows the period you are currently in, green when met and red when behind, with the hit rate across the selected range, your current and best streak, and a bar per recent period underneath. Goals belong to a visualization rather than to a property, so one property can carry a consistency goal ("3 days a week") and a volume goal ("150 reps a week") side by side.
### Maximize View
![[Life Tracker plugin for Obsidian - maximize view.png]]
Expand any visualization to full view for detailed analysis. Press Escape to exit.
### Life Tracking Grid
![[Life Tracker plugin for Obsidian - life tracking grid.png]]
Use the Life Tracking Grid (custom base view) to quickly capture your data.
### Data Entry Modal
Use the "Life Tracker: Capture properties" command to capture data easily:
Invoked on a specific note:
![[Life Tracker plugin for Obsidian - specific note modal.png]]
Invoked in a Life Tracking Base view:
![[Life Tracker plugin for Obsidian - invoked on a set of notes.png]]
### Global Settings and Presets
![[Life Tracker plugin for Obsidian - global settings and presets.png]]
Configure animation duration and create visualization presets that auto-apply to properties matching specific name patterns.
## References
- Community: https://community.obsidian.md/plugins/life-tracker
- Documentation: https://dsebastien.github.io/obsidian-life-tracker-base-view
- Sources: https://github.com/dsebastien/obsidian-life-tracker-base-view
- Release notes: https://github.com/dsebastien/obsidian-life-tracker-base-view/releases
- Roadmap: https://github.com/dsebastien/obsidian-life-tracker-base-view?tab=readme-ov-file#roadmap
## Related
- [[Announcing Life Tracker - A New Obsidian Plugin (Article)]]
- https://www.dsebastien.net/announcing-life-tracker-a-new-obsidian-plugin/
- [[Obsidian Bases]]