Playback controls, timeline navigation, and customizable date overlays for Obsidian's built-in graph timelapse.

• Reliable pause and resume: continue from the current graph progression instead of restarting the animation.
• Timeline controls: replay, skip backward, skip forward, or jump to an exact percentage of the graph timeline.
• Adjustable playback speed: choose a speed from the graph controls or enter a custom multiplier from 0.1x to 10x.
• Date overlays: display the current timelapse date as YYYY-MM-DD, a localized date, a localized date and time, YYYY-MM, or YYYY.
• Flexible placement: position the date in any corner or use the large centered hero style.
• Appearance controls: customize the date scale, font family, font weight, text color, background, and opacity.
• Optional keyboard controls: control the animation without leaving the global graph view.

Once the plugin is available in the Obsidian community directory:

1. Open Settings → Community plugins.
2. Select Browse and search for Graph Animation Controller.
3. Select Install, then Enable.

1. Download main.js, manifest.json, and styles.css from the latest release.

2. Create this folder inside your vault:

   <vault>/.obsidian/plugins/graph-animation-controller/
   

3. Copy the downloaded files into that folder.

4. Restart Obsidian or reload the app.

5. Open Settings → Community plugins and enable Graph Animation Controller.

1. Open Obsidian's Graph view.
2. Start the built-in timelapse animation.
3. Use the added controls to replay, seek, pause or resume, and change the playback speed.
4. Select the date overlay to open the timeline and position controls.

The plugin settings are available under Settings → Graph Animation Controller. You can configure seek distances, timeline step size, date formatting and placement, appearance, and keyboard controls there.

Keyboard controls are disabled by default. Enable them in the plugin settings before use.

Shortcuts only apply while the global graph view is active. They are ignored while typing in inputs and other editable controls.

Obsidian does not provide a public API for graph timelapse internals. This plugin therefore integrates with private runtime objects such as dataEngine, progressionSpeed, and renderProgression(). An Obsidian update may change these internals and temporarily break the plugin.

Additional limitations:

• Only the global graph view is supported. Local graph views may expose a different runtime structure.
• Timeline dates follow Obsidian's graph ordering and use the earlier of each file's creation and modification timestamps. Frontmatter dates are not used.
• Keyboard pan and zoom speed are not modified.

If an Obsidian update causes a regression, please open an issue and include your Obsidian version and operating system.

Requirements:

• Node.js 18 or later
• npm

Install dependencies and create a production build:

npm install
npm run build

Build artifacts are written to dist/:

dist/
├── main.js
├── manifest.json
└── styles.css

For development, run the esbuild watcher:

npm run dev

Bug reports and focused pull requests are welcome. Before submitting a change, make sure npm run build completes successfully and describe how the behavior was verified in Obsidian.

Released under the MIT License.