Welcome to the GitSync Wiki

GitSync is a mobile Git client for Android and iOS, designed to sync a remote repository with a local folder seamlessly. With support for multiple authentication methods and flexible sync triggers, GitSync helps developers manage Git workflows directly from their devices.

---

🔍 About GitSync

• One-time setup with background syncing
• Full sync capabilities (clone, fetch, pull, commit, push)
• Merge conflict resolution
• Supports GitHub, GitLab, Gitea, SSH, and HTTP/S
• Manual and automatic sync triggers (tiles, intents, app open/close)
• Custom commit messages and .gitignore editing

---

📚 Quick Links

I don't have a Git repository yet

Learn how to create a repository and start syncing from scratch

I have a remote repository but haven't cloned it

Steps to clone and sync your repository with GitSync

I want to set up git syncing on desktop too!

Steps to setup Obsidian-Git for Desktop

I want to explore more setup options

• Authentication Methods
• Sync Options & Triggers
• Repository Settings

• Troubleshooting

---

Features Overview

• Full Git operations: clone, pull, push, fetch, commit, status, branch creation
• Branch management: create, list, switch between branches (no GUI for merge/rebase)
• Signed commits using OpenSSH keys only (no GPG/PGP support yet)
• Built-in file explorer: create, rename, delete files and folders
• In-app plaintext editing with syntax highlighting (code, config, Markdown, etc.)
• Authentication: GitHub, GitLab, Gitea, SSH keys, HTTP(S) with personal access tokens
• Background sync with customizable triggers:
  • Android: App sync on app open/close recommended
  • iOS: App sync or Enhanced Scheduled Sync recommended
• Sync per repository with multiple repos supported
• Merge conflict detection and resolution interface
• Edit .gitignore, custom commit messages
• Backup & restore via encrypted export (password-protected, custom format)
• No file diff viewer outside merge conflicts (viewing diffs requires external tools)

Known Limitations & Missing Features

• No submodule support
• No support for branching/merging beyond basic switching and creation
• No Git hooks support
• No pull request creation or management

Git LFS and Git Filters (git-lfs, git-crypt) are now available with Premium.

---

💬 Support & Contributions

• Report bugs to bugs.viscouspotential@gmail.com
• Sponsor the project
• Star the repo if you find it helpful!
• If you need a missing feature, open an issue on GitHub or suggest it in Discussions.

GitSync is open source - contributions and feedback are welcome.

---

Back to Homepage
Back to GitHub Repository