obsidian-plugin/dsebastien_obsidian-time-machine
1
0
Fork 0
mirror of https://github.com/dsebastien/obsidian-time-machine.git synced 2026-07-22 07:02:16 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
dsebastien_obsidian-time-ma.../docs
History
github-actions[bot] 6c61f12bfb chore(release): 1.0.8
2026-07-17 07:41:28 +00:00
..
_config.yml docs(all): updated docs 2026-04-15 21:06:18 +02:00
configuration.md docs(all): updated docs 2026-04-15 21:06:18 +02:00
README.md docs(all): updated docs 2026-04-15 21:06:18 +02:00
release-notes.md chore(release): 1.0.8 2026-07-17 07:41:28 +00:00
tips.md fix(plugin): follow text cursor so continuous-scroll views track the right file 2026-06-17 10:55:10 +02:00
usage.md fix(all): fixed issue with diffs and improved rendering 2026-06-09 10:47:19 +02:00

README.md

title nav_order permalink
Overview 1 /

Time Machine

Browse, compare, and restore previous versions of your notes using Obsidian's built-in file-recovery snapshots and git commits.

Key features

  • Timeline slider to scrub through snapshots of your notes
  • Colored diff view showing exactly what changed between a snapshot and your current file
  • Selective restore -- restore an entire version or just individual changes (hunks)
  • Git integration -- git commits appear alongside File Recovery snapshots on the same timeline (desktop only)
  • Source indicators -- each snapshot shows its origin (File Recovery or git commit with hash and message)
  • Smart deduplication -- identical snapshots across sources are merged, keeping only the most recent
  • On-demand snapshots -- force-create a File Recovery snapshot at any time via command
  • Auto-updates when you switch files -- no manual refresh needed
  • Works on desktop and mobile (git features are desktop-only)

Quick start

  1. Make sure the File Recovery core plugin is enabled in Settings -> Core plugins
  2. Install and enable Time Machine
  3. Open the command palette and run Time Machine: Open view
  4. The sidebar panel shows snapshots for the active file -- use the slider to browse them

If your vault is a git repository, git commits will automatically appear on the timeline alongside File Recovery snapshots.

Snapshot sources

Time Machine reads from two sources:

  • File Recovery -- Obsidian's built-in core plugin that automatically saves snapshots at a configurable interval (default: every 2 minutes). Works on all platforms.
  • Git -- If your vault is inside a git repository and you're on desktop, Time Machine fetches the commit history for each file. This is read-only; Time Machine never creates commits or modifies the repository.

If File Recovery is disabled, Time Machine will show a notice but still work if git is available. If neither source has data for a file, an empty state message is shown.

About

Created by Sebastien Dubois.

Buy me a coffee to support development.