Skip to content

docs(syncing): describe current Android sync state#175

Merged
ErikBjare merged 2 commits into
ActivityWatch:masterfrom
TimeToBuildBob:android-sync-docs-1357
Jul 25, 2026
Merged

docs(syncing): describe current Android sync state#175
ErikBjare merged 2 commits into
ActivityWatch:masterfrom
TimeToBuildBob:android-sync-docs-1357

Conversation

@TimeToBuildBob

Copy link
Copy Markdown
Contributor

Summary

Replaces the stale "Note that syncing is not available on Android, yet." line
with an accurate description of the current state, per ActivityWatch/activitywatch#1357:

  • Push works but pull is a no-op (scoped storage since Android 11 blocks
    Syncthing/etc. from reading the app's sync dir).
  • Automatic sync is now off by default (feat(sync): disable automatic sync by default aw-android#184, merged),
    with no user-facing toggle yet.
  • Links to activitywatch#1357, which tracks the follow-up setup flow (Storage
    Access Framework directory picker + settings UI).

Related

Replace the stale 'not available yet' note with an accurate description:
push works but is scoped-storage-trapped, pull is a no-op, and automatic
sync is now off by default (ActivityWatch/aw-android#184). Links to
activitywatch#1357 which tracks the follow-up setup flow.
@greptile-apps

greptile-apps Bot commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Expands the syncing documentation with the current Android limitations.

  • Documents the app-private synchronization directory and scoped-storage restriction.
  • Explains that automatic background synchronization is disabled by default.
  • Links to the planned Android setup-flow work.

Confidence Score: 4/5

The directional explanation should be corrected before merging so readers are not given a reversed definition of pulling data from other devices.

The new section labels getting locally produced data off the phone as “pull from other devices,” even though pulling remote data describes bringing it onto the phone.

Files Needing Attention: src/syncing.rst

Important Files Changed

Filename Overview
src/syncing.rst Adds the Android synchronization-status section, but reverses pull direction in its explanation of moving data off the phone.

Reviews (1): Last reviewed commit: "docs(syncing): describe current Android ..." | Re-trigger Greptile

Comment thread src/syncing.rst Outdated
'get that data off the phone (pull from other devices)' reversed
the direction — getting data off the phone is a push, not a pull.
Greptile caught this in PR ActivityWatch#175 review.
@ErikBjare
ErikBjare merged commit 7f577d8 into ActivityWatch:master Jul 25, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants