mvrtza / 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.

What's New

Version 1.10.0

• Add annotation mode for month view (examples)
• Add parameters xAxisTickInterval, yAxisTickInterval, xAxisTickLabelFormat and yAxisTickLabelFormat for the line and bar chart (examples)
• Allow using regular expression in parameter dateFormatPrefix and dateFormatSuffix (examples)
• Add parameters file, specifiedFilesOnly, fileContainsLinkedFiles, and fileMultiplierAfterLink to retrieve data from specified files (examples)
• Add a parameter textValueMap to convert texts or emojis to specified values (examples)
• Fixed bugs
• Enhanced error messages

Version 1.10.1

• Fixed 'failed to load plugin' on iOS

Version 1.10.2

• Fixed plugin not rendering on some macOS machines

Version 1.10.3

• Allow using the parameter fitPanelWidth with the output type month and pie
• Fixed the resizing and positioning of the chart tooltip

Version 1.10.4

• Allow using a regular expression as a key of the parameter textValueMap
• Add a parameter shiftOnlyValueLargerThan to determine when to do valueShift
• Fixed bugs reported by users
• Fixed typo in plugin settings

Version 1.10.5

• Allow using a relative date value in initMonth in the month view

Version 1.10.6

• Fixed the coloring for missing data in the month view

Version 1.10.7

• Allow using html image tags as emoji inputs

Version 1.10.8

• Fixed startDat/endDate misread as a relative date

!!! 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.

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