Vinzent03/obsidian-git
Obsidian Git
obsidian-git is a version control integration for personal knowledge management that enables local file versioning and synchronization. It provides Git-based tracking for local files to allow for history auditing, document reversion, and the backup of notes to remote servers.
The project automates the version control process through scheduled background syncing, which triggers automatic commits and pushes at set intervals or during application startup. It facilitates collaborative editing by using branches and synchronization to manage contributions and merge changes.
The toolset covers comprehensive repository management, including initializing local repositories, managing file changes, and browsing commit history. It also includes a diff viewer to visualize additions, modifications, and deletions between different file versions.
Features
- Git Repository Integrators - Integrates a pure JavaScript Git implementation to perform version control operations within the application runtime.
- Version Control Integrations - Provides deep integration with Git to track local file changes, audit history, and revert document versions.
- Synchronization Strategies - Enables the backup and synchronization of personal notes to remote servers using Git to ensure cross-device consistency.
- Versioning & Change Tracking - Implements content revision and change tracking by utilizing Git repositories for the underlying storage.
- Automated Backups - Automates periodic commits and pushes to create reliable, versioned mirrors of notes on remote repositories.
- Background Task Schedulers - Automatically triggers commit and push sequences based on time intervals or application lifecycle events.
- Staged File Indexers - Detects file modifications by comparing the current filesystem state against the local Git index.
- Interval-Based Task Execution - Triggers synchronization sequences at fixed time intervals using a background timer to automate backups.
- Remote Repository Syncing - Synchronizes local project data with remote servers by cloning repositories and pushing or pulling changes.
- Staging and Commit Interfaces - Provides a dedicated source control interface and editor indicators to stage and commit file modifications.
- Version Control Automation - Schedules automatic commits and pulls to keep remote stores updated during startup or at set intervals.
- JavaScript-Native Implementations - Performs all version control operations using a JavaScript library instead of relying on a system-installed Git binary.
- Local-First Architectures - Prioritizes local data storage and tracking by comparing disk state against a local Git index.
- Collaborative Editing Tools - Uses Git branches and synchronization to manage contributions and merge changes for collaborative knowledge base editing.
- Repository Initialization - Provides capabilities to create new local repositories and configure ignore files.
- Change Visualization - Provides visual feedback for identifying modifications between different versions of notes.
- JSON Configuration Schemas - Persists user preferences and repository settings in a structured JSON file to drive runtime behavior.
- Configuration Workflows - Uses a persistent JSON settings object to define synchronization behavior and remote targets.
- Commit Histories - Allows users to track project evolution by reviewing a log of previous changes, authors, and modified files.
- Version Control Visualizers - Renders a visual representation of textual changes by calculating line-by-line differences between file versions.
