App Sync

Syncs when apps are opened or closed

iOS

GitSync Open/Close Sync

The simplest way to keep your repo up to date on iOS is by syncing your repository when the app is opened and closed.

• Enable App Sync in Sync Settings (on by default)
• GitSync will automatically sync when you open or close the app

Sync on Other App Open/Close (via Shortcuts)

You can trigger a sync automatically when another app (e.g. Obsidian) is opened or closed using iOS Shortcuts automations.

This is the recommended approach for notes apps like Obsidian on iOS

Setup steps:

1. Open the Shortcuts app
2. Go to the Automation tab → tap + → select App
3. Select the app you want to trigger syncing (e.g. Obsidian)
4. Choose Is Opened, Is Closed, or both
5. Set to Run Immediately (no confirmation prompt)
6. For the action, search “Sync Now”
7. Save the automation

"Sync Now" syncs the default/selected repository. No index parameter is needed.

Looking for advanced intent/URL scheme options?

See Custom Intent (advanced) for widget intents, deep links, and repo index parameters.

---

Android

• Enable the auto sync feature
  • This will prompt you to enable the Git Sync Accessibility Service
  • This service is used to watch for the selected app being opened and closed (ignoring keyboards)
  • No data is collected or stored
• Select an application to watch
• Turn on/off sync on application opened or closed

---

For Open Source APK Users: Enable Restricted Settings

Apps installed from outside the Play Store (like the open source APK) are restricted by default. See Troubleshooting for detailed instructions.

To allow restricted settings (e.g., accessibility permissions):

1. Go to Settings > Apps
2. Tap “See all apps”
3. Find and select Git Sync
4. Tap the three-dot menu (•••) > App info
5. Tap Permissions > Restricted settings
6. Toggle “Allow restricted settings” to On

If you don’t see “Restricted settings”, your ROM may not support it. Some custom ROMs block this option.
The open source APK does not require Google Play Services and is fully compatible with privacy-focused ROMs.