mfrank2016 / obsidian-tracker

A plugin tracks occurrences and numbers in your notes

Obsidian Tracker Plugin

This is an Obsidian plugin that helps you collect data from notes and represent it comprehensively.

Here is a table containing simplified examples showing what you can track.

!!! Breaking Changes !!!

From version 1.9.0, template variables, e.g. '{{sum}}', are deprecated. Instead, Tracker provide operators (+, -, *, /, %) and functions (dataset(), sum(), maxStreak(), ......etc) to help us do data processing. For users having code blocks from previous version, please replace '{{sum}}' by '{{sum()}}' or '{{sum(1)}}' by '{{sum(dataset(1))}}'. More information about the new expressions could be found here.

What's New

Version 1.9.0

• Add a new output type pie, rendering a pie chart (examples)
• Allow expressions (operators and functions) as data inputs for output type summary, bullet, and pie (examples: expression, summary, bullet, pie)
• Allow formatting evaluated expressions by a follwing format string (examples)

Version 1.9.1

• Fixed errors on collecting time values from dvField
• Fixed errors on collecting wiki while fileCache.links is undefined

Version 1.9.2

• Allow using seconds in time values
• Fixed error parsing dvField

Usage

1. Have some targets you want to track in daily notes.
2. Add a new note for displaying the tracker.
3. Add tracker code blocks manually (examples) or using commands.
4. Switch the document view mode to 'Preview', then the code block will get rendered.

For more use cases, please download and open the examples folder in obsidian with this plugin installed and enabled.

More Details You May Want to Know

• Installation: Install the plugin from Obsidian or install it manually
• Concepts: Explain how this plugin works and what to setup
  • Target Evaluation
  • Input Parameters
  • Expressions
• Examples
• Plugin Settings
• Release Notes
• Road Map
• Frequently Asked Questions

Support

• If you like this plugin or want to support further development, you can Buy Me a Coffee.
• Please report bugs and request features in GitHub Issues