Repository navigation
Ogresync v1.0.0
After months of development and testing, we're excited to release the first stable version of Ogresync - a free, open-source solution for synchronizing Obsidian vaults across devices using GitHub.
What is Ogresync?
Ogresync solves the problem of keeping your Obsidian notes synchronized without paying for Obsidian Sync. It uses GitHub as a backend and provides a desktop application that handles all the complexity of Git operations, conflict resolution, and synchronization automatically.
Key Improvements in v1.0.0
Intelligent Workflow Management
- Completely redesigned sync process that eliminates common Git conflicts
- Pre-sync checks ensure your vault is ready before you start editing
- Post-sync processing handles any conflicts that arise during your session
- Real-time monitoring of your Obsidian editing sessions
Advanced Conflict Resolution
- Two-stage resolution system: high-level strategy selection followed by file-level editing
- Smart merge algorithms that preserve your content and Git history
- Automatic backups created before any conflict resolution
- Support for external editors (VS Code, Notepad++, etc.) for complex merges
Enterprise-Grade Safety Features
- Comprehensive backup system with descriptive folder names and recovery instructions
- All operations are non-destructive - you can always roll back changes
- Local-only backups that never sync to your repository
- Automatic cleanup of old backups to prevent disk space issues
Offline Support
- Works seamlessly without constant internet connection
- Smart detection of when you go offline/online
- Automatic sync when connection is restored
- Conflict resolution triggered only when necessary
Installation Requirements
Before installing, make sure you have:
- Obsidian installed on your system
- Git installed and configured
- A GitHub account with a repository for your notes
Platform Support
- Windows: Download
ogresync.exe - Linux: Download
ogresync.AppImage - macOS: Coming in a future release
Getting Started
- Download the appropriate file for your platform
- Run the application - it will launch a setup wizard
- Follow the 11-step setup process (takes about 5-10 minutes)
- Start using Ogresync instead of opening Obsidian directly
The setup wizard guides you through everything: Git configuration, SSH key generation, GitHub repository linking, and initial synchronization.
How It Changes Your Workflow
Instead of opening Obsidian directly, you now:
- Launch Ogresync
- It automatically syncs your vault and opens Obsidian
- Edit your notes normally
- Close Obsidian when finished
- Ogresync handles pushing your changes
This ensures your vault is always synchronized before and after editing.
Technical Notes
- Built with Python and Tkinter for cross-platform compatibility
- Uses Git under the hood for version control and synchronization
- Stores configuration in OS-appropriate directories
- All sync operations preserve Git history for full traceability
Known Limitations
- This is the first stable release - please report any issues you encounter
- Large vaults (1000+ files) may take longer on initial setup
- Some antivirus software may flag the executable as unknown - this is normal for new applications
Support & Contributing
- Report bugs or request features through GitHub Issues
- Contribute to development via Pull Requests
- Join discussions in the GitHub Discussions section
We built Ogresync because we believe everyone should have access to reliable note synchronization without subscription fees. It's completely free and always will be.
Important: Create a private GitHub repository if you want to keep your notes confidential.
Ready to try it? Download for your platform below and follow the setup wizard.