Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

TraceTime

BearBear1k downloads

Show when each block of a note was last edited.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates6

TraceTime is an Obsidian plugin that tracks and displays the last edited time of every block (paragraph, heading, code block, list, table…) in your notes, with labels aligned to the right of the document area.

Features

  • Block-level time tracking: incremental re-parsing via CodeMirror ChangeSets — only blocks near the edit are touched, never a full-document diff
  • Undo/redo aware: restoring content with Ctrl+Z restores its original timestamp (content-hash session history)
  • External change recovery: timestamps migrate by block hash when files are changed by sync tools or other editors
  • Configurable display rules: a ladder of formats (just now → minutes ago → hours ago → today → yesterday → days ago → this year → full date) with a live-preview settings tab
  • Timestamp rollback: every write keeps a one-generation backup; restore from the settings tab if timestamps ever get clobbered
  • Performance first: millisecond incremental path, viewport-only rendering, debounced batched writes, no full-vault scan on startup
  • Multi-language UI: settings and labels available in English, 中文, and Português (BR), auto-detected from Obsidian's language setting (falls back to English)

Data storage

Time data lives in <vault>/.obsidian/plugins/tracetime/records/, one MessagePack record per Markdown file. Note content is never stored — only block hashes, the first/last 32 normalized characters of each block, and timestamps.

Installation

Manual

Copy main.js, manifest.json, styles.css into <vault>/.obsidian/plugins/tracetime/ and enable the plugin in Settings → Community plugins.

BRAT

Install the BRAT plugin and add the repository QuincySx/obsidian-tracetime.

Development

npm install
npm run dev    # watch build
npm run build  # type check + production build
npm test       # core logic self-tests
npm run pack   # package dist/tracetime-<version>.zip

Release

Commit and push the version bump first (npm version patch --no-git-tag-version updates all version files). In GitHub, open Actions → Release Obsidian plugin → Run workflow and choose the branch to release. Leave version empty to use package.json, or enter that same version explicitly without a v prefix.

The workflow validates the version files, runs tests and builds, then creates the tag and a draft release with the plugin files attached. Review the draft and publish it manually. Tags pushed from your terminal continue to use the same release workflow.


TraceTime(中文)

TraceTime 是一个 Obsidian 插件:为笔记中的每个块(段落、标题、代码块、列表、表格……)记录并显示"最后编辑时间",标签统一显示在文档区右侧。

特性

  • 块级时间追踪:编辑时通过 CodeMirror ChangeSet 做增量窗口重解析,只处理改动附近的块,不做全文 diff
  • 撤销/重做感知:Ctrl+Z 撤销后内容回到旧版本,时间戳一并恢复(基于内容哈希的会话历史栈)
  • 外部修改恢复:同步软件或其他编辑器改动文件时,按块哈希回迁时间戳
  • 可配置的显示规则:阶梯式规则(刚刚 → N 分钟前 → N 小时前 → 今天 → 昨天 → N 天前 → 今年 → 完整日期),设置页带实时预览
  • 时间戳回滚:每次写入前自动保留上一代备份,误刷后可在设置页一键恢复
  • 性能优先:毫秒级增量路径、视口内渲染、防抖批量落盘、启动不扫描全库
  • 多语言界面:设置页和标签支持英文、中文、葡萄牙语(巴西),根据 Obsidian 的语言设置自动选择(未识别时回退到英文)

数据存储

时间数据保存在 <库>/.obsidian/plugins/tracetime/records/,每个 Markdown 文件一条 MessagePack 记录,不保存笔记正文(只存块哈希、前后各 32 个标准化字符和时间戳)。

License

MIT

发版

先更新版本(npm version patch --no-git-tag-version),提交并推送代码。然后在 GitHub 打开 Actions → Release Obsidian plugin → Run workflow,选择要发布的分支;version 留空时读取 package.json,也可填写相同版本号(不加 v 前缀)。

流程会校验版本信息,运行测试和构建,再创建 tag 和带插件文件的草稿 Release。检查草稿后手动发布即可。终端推送 tag 的方式仍然可用。

Localization

The localization system supports adding new languages through the locale files in src/locales/. Locale files use BCP 47 language tags when a regional variant is relevant (for example, pt-BR or es-ES). The locale key, file name, and runtime identifier must match exactly. For instructions on adding a new language, see src/locales/README.md.

本地化

本地化系统支持通过 src/locales/ 中的语言环境文件添加新语言。 当需要使用区域变体时,语言环境文件应使用 BCP 47 语言标签(例如 pt-BR 或 es-ES)。语言环境键、文件名和运行时标识符必须完全一致。 有关如何添加新语言的说明,请参阅 src/locales/README.md。

HealthExcellent
ReviewSatisfactory
About
Record and display last-edit timestamps for every block (paragraphs, headings, code blocks, lists, tables) with labels aligned to the right side of the editor. Restore timestamps after undo/redo and external file changes, support rollback to previous generations, and track edits incrementally per-block for low-latency rendering.
AnnotationDates
Details
Current version
0.1.6
Last updated
Last month
Created
4 months ago
Updates
6 releases
Downloads
1k
Compatible with
Obsidian 1.5.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
BearBearbear
www.bearpanel.top/
GitHubquincysx
  1. Community
  2. Plugins
  3. Annotation
  4. TraceTime

Related plugins

Admonition

Admonition block-styled content.

Thino

Quickly capture memos and display them in the sidebar with a heatmap. (Closed source)

Tasks

Track tasks across your vault. Supports due dates, recurring tasks, done dates, sub-set of checklist items, and filtering. Maintained by Clare Macrae and Ilyas Landikov, created by Martin Schenck.

Vault Todos

Collect all outstanding TODOs from your vault and presents them in lists Today, Scheduled, Inbox and Someday/Maybe.

Day Planner

Turn tasks from daily notes, the Tasks plugin, and calendars into time blocks on an editable timeline, with built-in time tracker.

Full Calendar Remastered

Complete Calendar HUB experience. Work with all your calendars in one place. Analyze your time and take action!

Update modified date

Automatically update a frontmatter modified date field when the file is modified.

HiNote

Add comments to highlighted notes, use AI for thinking, and flashcards for memory.

Journals

Manage your journals.

Itinerary

Make planning your trip or event easier by rendering a calendar from event information found in your notes.