Frequently Asked Questions (FAQ)

This chapter summarizes the most common issues and solutions for GarSync 2.x users.


1. Accounts & Authorization

Q: Why are there two Garmin icons? Which one should I choose?

A: Garmin operates two isolated server regions: China and Global.

Q: Both Garmin accounts (Global and China) are logged in, but data syncing isn't progressing. Why?

A: This is generally caused by two issues:

Q: What do errors 401 and 429 mean?

A: Error 401 means "Unauthorized" (session expired), while 429 means "Too Many Requests" (rate limited).

Solutions:

2. Data Synchronization

Q: Will syncing cause duplicate activities?

A: No. GarSync employs an intelligent deduplication algorithm. It uses the original timestamp as a unique footprint. Even if you cross-sync from multiple platforms, the system detects the same activity and skips redundant uploads.

Q: How do I sync historical records?

A: When creating a sync task, check the "Sync History" option. You can also trigger a "Full Refresh" in Account Management to force-scan all data. Warning: Do not do this frequently, as high-frequency scanning may lead to account restrictions by the platform.

Q: Do you support Huawei Health?

A: Currently, we only support importing Huawei's offline data packages. Direct account sync is not supported as Huawei has not approved our write-permission request.

To export your data for migration:

Q: Does GarSync support Apple HealthKit?

A: Yes. However, due to Apple HealthKit's privacy sandbox, the App must be running active to read data.

Q: Why can I only read Apple Watch records from Apple Health?

A: Many third-party apps only write summary data to HealthKit, lacking detailed tracks or heart rate metrics. GarSync ignores low-quality summaries by default to ensure data integrity.

Q: Activities sync to Blackbird as "Success" but aren't visible?

A: Blackbird may return errors that GarSync ignores to prevent infinite loops:

Q: Sync failed with "500 Internal Server Error"?

A: This usually indicates temporary platform instability. Tap "Retry". If it persists, it could be an API change—please wait for an App update.

Q: I cannot connect to my NAS?

A: Please check:

  1. Your phone and NAS are on the same local network (or VPN/DDNS is correctly set).
  2. SMB v2/v3 is enabled (SMB v1 is not supported for security reasons).
  3. Firewall allows access to port 445.

3. Service & Pricing

Q: Why does GarSync charge when there are open-source projects available?

A: Open-source projects are often just code fragments. GarSync is a polished App, a complete suite of tools, maintenance, and technical support.

  1. GarSync includes data backup, analysis, visualization, AI coaching, and even professional sensor/trainer connectivity.
  2. Most open-source projects only cover a small fraction of platform sync logic, failing to meet comprehensive needs.
  3. Using open-source tools requires professional skills (like programming). GarSync is built for regular users.
  4. Open-source projects often lack dedicated support and full-time maintenance, leading to slow responses or unmaintained code.
  5. GarSync is a professional, full-time commitment providing frequent updates and responsive customer support.

Q: Can I use GarSync for free?

A: Simply put, you can try it for free, but long-term use requires payment.

Q: What is the pricing standard for data syncing?

A: We charge based on quantity: 1 Diamond per activity, capped at 68 Diamonds for large migrations (100+ activities).


4. Data Ownership

Q: What if a platform does not support data export?

A: We respect all platforms' Terms of Service and encourage friendly communication.


5. Privacy & Security

Q: Does GarSync store my activity data?

A: We strictly follow the "Data Sovereignty" principle.