Wordflow Tracker

中文文档 | English

Introduction

WordFlow Tracker is a lite plugin that tracks your focused time and edit statistics on each note and automatically records to your daily note or periodic notes.

Core Features

• Tracking the focused time, number of edits, edited words per note.

• Display the portions of statistics with multiple views:

  • file list view:

    

  • tag list view: with collapsible groups and dual-layer progress bars

    

  • heatmap view: with custom color gradients and note navigation

    

• Customize status bar content with field aliases for personalized display.

  

  

• Record the modified data automatically when the note is closed. Alternatively, use command or button to record all notes.

• Display the changes in the side pane widget.

  

• Display changes in a bar style to show the portion of original contents(yellow) v.s. modified contents(red: deleted words, green: added words).

  

• Record edited statistics such as total words you edited today, to the YAML(Frontmatter) of daily note. Other plugins could use these metadata to generate analysis.

• Customization of which data to be recorded with ${dataName}, see Supported String Interpolations.

• Customization of how the data to be recorded, like inserting a table or a list to the specified position of your note. Preview recording syntax before applying changes.

How does this plugin collect data?

We fetch the edit statistcs by access the history field of Obsidian editor, which is the place to store the undo/redo history of Obsidian.

• No extra history database is created, thus don't worry about the performance burdens in large vault.
• No extra data file is created or exposed. This resolves the privacy concerns.

All statics are fetched by diectly reading the Obsidian data, without adding additional thread to record the data, which means that enabling the recording will bring almost no performance loss or extra RAM occupation.

The temporary edit stats collected by the plugin are destroyed after recording to your note, and the Obsidian will destory the history data after you close the application.

Guide for beginners

Step 1: Download and install the plugin.

Step 2: Enable the plugin in Obsidian > Settings > Community plugins.

Step 3: In Wordflow Tracker settings, specify your periodic note folder for placing your periodic notes, in which the edit stats will be saved.

Now the plugin will automatically track the edits you made and display them in the status bar. The edits stats will also be recorded to your periodic note, when any one of the following is met:

1. you switch from editing mode to reading mode in Obsidian;
2. you close a tab of notes after editing them;
3. you manually click the button "Record wordflows from edited notes" in the left ribbon of Obsidian;
4. you manually run the command "Record wordflows from edited notes to periodic notes" in Obsidian;
5. the automatic recording interval is timed out, which could be set in the setting of Wordflow Tracker plugin, to record all edited notes.

Note: the tracker will be set to 0 once the note is recorded.

Advanced guide for customization

Apply templates to newly created notes before recording

Make sure your template will be applied to notes under the same periodic note folder.

If your newly created notes will be renamed by other plugins, such as Templates(core plugin) or Templater(community plugin), make sure that the name that other plugin specified is the same as periodic note format

Customize which data to be recorded

In wordflow recording syntax, you can add or delete the data in one of the following formats:

• Table: Specify the name in heading for ${modifiedNote} in markdown table format, such as "Document words" and add "${docWords}" to the row. Available properties are listed in supported string interpolations.

  

  After completing the markdown table in the syntax, you can preview the result below and will be prompted to confirm changes:

  

  Note: ${modifiedNote} must exist in the table syntax, or the recorder will have trouble merging the existing data of note with the new data

• Bullet List:

  Add a linebreak, press the tab key for proper spacing, and specify any name you expect for this data.

  Lastly, add a string interpolations like "${docWords}". You can preview the result below and will be prompted to confirm changes:

  

  Note: ${modifiedNote} must exist in the bullet list syntax, or the recorder will have trouble merging the existing data of note with the new data

• Metadata:

  Just like adding a metadata in "source mode", you can add a property name ends with ':', and a string interpolations after it, like "${totalWords}"

  

Record edit stats to both note content and yaml(frontmatter)

In plugin settings, create a recorder by clicking the add button:

Then, adjust the perodic note folder and note format to the same as the other recorder, to record on the same note.

Lastly, adjust the record content type to a different one.

Note that you should avoid having the same record content type of 2 recorders that target on the same note. For example, avoid having one recorder which inserts table to the bottom of today's daily note, while having the other recorder which inserts table to a custom position of today's daily note.

Record edit stats to a dynamic folder

You can record edit statistics to not only a static folder, such as "Daily Notes/2025-03-23.md", but also on a dynamic folder like: "Daily Notes/2025-03/2025-03-23.md".

For details regarding how to implement this, see Enable dynamic folder

Please also ensure that this folder is the same folder where templates from other plugin will be applied.

Settings documentation

See settings documentation.

Development Roadmap

See Development Roadmap for known issues and planned features!

Want to know how this project is built? Or wanna collaborate on this plugin? See details at https://deepwiki.com/LeCheenaX/WordFlow-Tracker

Installation

Install in Obsidian

Open obsidian settings > community plugins > browse，in the pop up windows, search for Wordflow Tracker, and click the install button.

After installed, click the enable button to start the experience.

Manually installing the plugin

Copy over main.js, manifest.json, styles.css to your vault VaultFolder/.obsidian/plugins/wordflow-tracker/.

Install via BRAT

See BRAT docs.

Similar plugins

This lite plugin tries to offer unique experience for tracking edits periodically with least obstacles. However, you can try the following alternatives if interested:

• Yourpulse plugin
• Daily File Logger
• Obsidian toggl integration