Obsidian Stats logoObsidian Stats

Activity Map

by Zhuo
5
4
3
2
1
Score: 51/100
Install Code

Description

A local-first Obsidian plugin that maps focused time across files and folders with interactive charts. 本地优先的 Obsidian 活动统计插件：按文件和目录可视化专注时间。

Reviews

No reviews yet.

Stats

3
stars
321
downloads
0
forks
61
days
56
days
56
days
5
total PRs
0
open PRs
0
closed PRs
5
merged PRs
0
total issues
0
open issues
0
closed issues
96
commits

Latest Version

0.2.3
2 months ago

Changelog

What's New

Activity Map v0.2.3 makes the Header Popover control row fully personal: arrange its six actions in Settings or edit them directly from the popover, without losing the current chart.

Features

  • Rearrange controls across either side of the fixed day navigation, or move them to a recoverable disabled row.
  • Long-press a control in the Header Popover to enter direct editing, then save or cancel the layout draft.

Improvements

  • Dragging now lifts the chosen control beneath the pointer, shows rounded dashed drop slots, and previews sibling reflow before it is placed.
  • The chart and legend stay visible during direct editing, and the result area remains vertically centred.

Documentation

  • Documented the control-row layout, editing boundaries, and user journeys.

Activity Map v0.2.3 让 Header Popover 的六个控制按钮可按个人习惯排列：既可在设置页调整，也可直接在浮层内编辑，同时始终保留当前图表。

新功能

  • 按钮可跨过固定的日期导航调整左右区域，也可移入可恢复的停用行。
  • 在 Header Popover 内长按按钮即可直接进入编辑，保存会写入草案，取消会恢复原布局。

改进

  • 拖动会将选中的按钮提起并跟随指针，以圆角虚线槽位和相邻按钮重排预览落点。
  • 直接编辑时图表和图例保持可见，结果区域维持垂直居中。

文档

  • 补充控制行布局、编辑边界和用户交互流程说明。

Full Changelog: https://github.com/ffy6511/obsidian-activity-map/compare/0.2.2...0.2.3

See all version on GitHub

README file from

Github

Screenshots

English · 简体中文

English

Activity Map is an Obsidian plugin that shows how you spend focused time across the files and folders in your vault.

Features

  • Per-file activity — Tracks active time, editing time, typed characters, and file-open counts for the file currently in focus.
  • Idle-aware tracking — Excludes idle, sleep, and lock-screen gaps from focused activity.
  • Explore by time and place — Inspect daily and historical activity, then drill from folders into files.
  • Header summary — Open a compact, pinnable activity chart from eligible file headers. Reorder, move between either side of the fixed day navigation, or recoverably disable its six action controls in Settings or by long-pressing a control in the popover; the chart remains visible during direct editing. Locate follows the current workspace file; any present-file slice first locates its row, a second click opens it, and Cmd/Ctrl-click opens a new tab immediately. File opening pins the chart for continued exploration.
  • Local poster export — Download the current result as a theme-matched PNG poster with an optional caption.
  • Local settings — Configure excluded paths, timing thresholds, and the Header Popover control row; editing the row does not customize the poster-export dialog.

Install

1. From Obsidian Community Plugins

In Obsidian, open Settings → Community plugins → Browse, search for Activity Map, then select Install and Enable. Disable Restricted Mode first if Obsidian asks you to do so.

2. Manual installation from a GitHub Release

Alternatively, install manually from a GitHub Release.

  1. Download these three release assets:

    File Purpose
    main.js Compiled plugin code
    manifest.json Obsidian plugin metadata
    styles.css Plugin styles

  2. Create this folder in your vault:

    <vault>/.obsidian/plugins/activity-map/

    If your vault uses a custom Obsidian configuration directory, replace .obsidian with that directory name.

  3. Copy all three downloaded files into that activity-map folder.

  4. Reload Obsidian, then enable Activity Map under Settings → Community plugins.

Requires Obsidian 1.7.2 or later.

Local development

Requirements: Node.js 20.11+ and npm.

npm install
npm run dev

npm run dev watches the source and writes main.js at the repository root. Copy main.js, manifest.json, and styles.css to your development vault’s plugins/activity-map/ folder, then reload Obsidian to test the change.

Data and privacy

Activity Map is local-first. It does not itself upload, sync, sell, or send your activity data anywhere.

  • No account, telemetry, analytics, remote API, or network upload is included.
  • Activity records stay in the plugin data directory inside your vault configuration directory.
  • It stores activity metadata locally so it can build your statistics.
  • It does not read or store note content, selected text, or the actual strings you type.
  • Poster downloads are created and saved locally.

Contributing

See CONTRIBUTING.md for development, validation, and pull-request guidance.

License

MIT

简体中文

Activity Map 是一款本地优先的 Obsidian 活动统计插件。它帮助你了解自己在 vault 各文件和目录上的专注投入.

功能

  • 逐文件活动统计：记录当前聚焦文件的活动时长、编辑时长、输入字符数和打开/切入次数。
  • 识别空闲与休眠：空闲、休眠和锁屏间隔不会计入专注活动。
  • 按时间与目录查看投入：查看每日和历史活动，并从目录逐层下钻到文件。
  • 页眉统计入口：从符合条件的文件页眉打开可固定的紧凑活动图表；可在设置中或在浮层内长按某个控制按钮后，对六个动作排序、跨过固定的中心日期导航调整左右区域，或恢复性停用，直接编辑时图表继续显示。定位始终跟随当前激活的工作区文件。任意分组下的现存文件切片无修饰键首次点击定位列表行，再次点击在当前页面打开文件，Cmd/Ctrl 首次点击直接新建 tab；打开文件后图表自动固定，方便继续浏览。
  • 本地海报导出：将当前结果下载为匹配主题的 PNG 海报，并可添加说明文字。
  • 本地设置：可设置排除路径、时间阈值和 Header Popover 控制行；控制行编辑不定制海报导出 modal。

安装

1. 从 Obsidian 插件市场安装

在 Obsidian 中打开 设置 → 第三方插件（Community plugins）→ 浏览，搜索 Activity Map，然后点击 安装 并 启用。如果 Obsidian 提示，请先关闭受限模式（Restricted Mode）。

2. 从 GitHub Release 手动安装

也可以从 GitHub Release 手动安装。

  1. 下载 Release 中的三个文件：main.js、manifest.json 和 styles.css。

  2. 在 vault 中创建目录：

    <vault>/.obsidian/plugins/activity-map/

    如果 vault 使用了自定义 Obsidian 配置目录，请将 .obsidian 替换为实际目录名。

  3. 将这三个文件全部复制到 activity-map 目录。

  4. 重载 Obsidian，在 设置 → 第三方插件（Community plugins） 中启用 Activity Map。

需要 Obsidian 1.7.2 或更高版本

本地开发

环境要求：Node.js 20.11+、npm。

npm install
npm run dev

npm run dev 会监听源代码并在仓库根目录生成 main.js。将 main.js、manifest.json 和 styles.css 复制到开发 vault 的 plugins/activity-map/ 目录，再重载 Obsidian 即可测试。

数据与隐私

Activity Map 坚持本地优先：插件自身不会上传、同步、出售或向任何地方发送你的活动数据。

  • 不包含账号体系、遥测、分析服务、远程 API 或网络上传。
  • 活动记录保存在 vault 配置目录下的插件数据目录中。
  • 插件只在本地保存构建统计所需的活动元数据。
  • 不读取或保存笔记正文、选中文本，也不保存你实际输入的字符串。
  • 海报只在本机生成和保存。

参与贡献

开发、验证和 Pull Request 说明见 CONTRIBUTING.md。

许可证

MIT

Sponsors