Obsidian Stats logoObsidian Stats

Hybrid Git Sync

by walkskyer
5
4
3
2
1
Score: 52/100
Install Code

Description

Hybrid Git Sync plugin

Reviews

No reviews yet.

Stats

15
stars
1,084
downloads
4
forks
78
days
4
days
4
days
1
total PRs
0
open PRs
0
closed PRs
1
merged PRs
7
total issues
0
open issues
7
closed issues
176
commits

Latest Version

1.2.4
5 days ago

Changelog

What's Changed

New Contributors

Full Changelog: https://github.com/wk-obsidian/HybridGitSync/compare/1.2.3...1.2.4

See all version on GitHub

README file from

Github

Hybrid Git Sync for Obsidian

English｜中文

🚀 An adaptive, cross-platform Git synchronization solution for Obsidian.
Enjoy high-performance Native Git execution on Desktop alongside a lightweight, zero-dependency Git Provider API on Mobile.

🌟 Introduction & Design Philosophy

Managing an Obsidian vault with Git across different operating systems usually requires distinct synchronization strategies due to platform-specific constraints. Hybrid Git Sync bridges this gap seamlessly by implementing an Adaptive Sync Engine.

Instead of applying a single approach to all environments, this plugin intelligently splits the synchronization workload based on the device you are currently using:

  • 💻 On Desktop (Windows/Mac/Linux): It invokes your local Native Git client. This guarantees maximum execution speed, reliability, and full support for complex repository histories or large assets.
  • 📱 On Mobile (iOS/Android): It bypasses mobile OS limitations by interacting directly with cloud REST APIs (GitHub / GitLab / Gitea). It reads and writes changes via lightweight HTTPS requests without requiring any local Git binary environments on your phone.

✨ Key Features

  • 🔄 Adaptive Hybrid Engine: Runs full native Git commands on your PC and shifts to clean, memory-efficient API requests on your mobile devices.
  • 🔒 Privacy Centric: Your Personal Access Tokens (PAT) are stored locally within Obsidian's secure configuration storage. No data ever leaves your device or touches intermediate servers.
  • ⚡ Conflict Resolution: Built-in smart synchronization logic helps track updates, reducing the risk of overwriting files during simultaneous multi-device editing.
  • 💰 100% Free & Open Source: A reliable, customizable, and fully self-hosted alternative for universal knowledge base backups.

📦 Installation

  1. Inside Obsidian, navigate to Settings -> Community Plugins.
  2. Click Browse and search for Hybrid Git Sync.
  3. Click Install, then toggle on Enable.

⚙️ Quick Setup Guide

Setting up Hybrid Git Sync takes less than 3 minutes:

  1. Repository Setup: Initialize your Obsidian vault as a Git repository on your desktop and push it to your hosting platform (GitHub, GitLab, or Gitea).
  2. Generate Token: Navigate to your Git provider's settings and create a Personal Access Token (PAT) with full repo read/write scopes.
  3. Mobile Configuration: Open the plugin settings on your mobile device, enter your Repository URL and the generated Token. Tap Sync to initiate your first transfer!

🤝 Feedback & Contributing

As this is a newly released plugin, your feedback is incredibly valuable! If you encounter any bugs, have feature requests, or want to support the project:

  • Please open an Issue or join the discussion in the Discussions tab.
  • If this plugin helps streamline your cross-platform workflow, consider dropping a ⭐ Star to help others discover it!

License

MIT

☕ Support

If you find this plugin useful and would like to support its development, you can support me on Ko-fi.

ko-fi

Sponsors