Inanis_Vault/21-Server Reference/homelab/stacks/n8n/JW_Backup/JW Backup.md

JW Library Sync System: Architecture & Roadmap

Date: 2026-03-31 Core Stack: Android (Tablet/Phone), Tasker, AutoInput, GitSync, Gitea, n8n, jwlFusion.

---

## SYSTEM OVERVIEW

1. Local Backup (Tablet & Phone)

• Trigger: Time-based (04:30 AM Tablet / 04:35 AM Phone).
• Action: Tasker copies the .jwlibrary export from the app's export location to the local vault directory.
• Sync: Tasker uses AutoInput to:
  1. Launch GitSync.
  2. Click the "Sync" or "Push" button for the vault repository.
  3. Wait for the notification/UI change indicating success.

2. Central Merge (The "Global Truth")

• Trigger: Tablet at 04:45 AM.
• Action: Tasker sends an HTTP POST to the n8n webhook (bunny-wyvern.ts.net).
• n8n Logic: 1. SSH into the server. 2. Pull all branch updates from Gitea. 3. Run jwlFusion to merge device backups into master.jwlibrary. 4. Commit and Push the merged file back to Gitea. 5. Return a 200 OK "Sync successful" message to Tasker.

3. Restoration (Sync Back)

• Action: Upon receiving the 200 OK, Tasker triggers the RestoreFromMaster task.
• Logic: GitSync pulls the latest master.jwlibrary, and Tasker (via AutoInput or intent) imports it back into the JW Library app.

---

## CURRENT CONFIGURATION (POST-INTENT DEPRECATION)

• GitSync: Bypassing Intent issues by using AutoInput to physically click the sync buttons.
• Storage: Vault is located at /storage/emulated/0/vault (Shared Storage).
• Git Settings: "Safe Directory" and "Credential Store" have been configured in the environment to prevent ownership/password prompts.

---

## TO-DO LIST (FOR TOMORROW)

• AutoInput Optimization: Refine the "Click" sequence in Tasker to ensure it handles the screen being off (using Turn On and Dismiss Keyguard actions).
• Validation Check: Run a manual end-to-end test:
  1. Manually trigger Tablet Sync.
  2. Manually trigger Phone Sync.
  3. Manually trigger n8n Webhook via Tasker.
• Error Handling: Add a Tasker "Else" condition for the HTTP Request—if n8n returns an error, send a Join/Gotify notification so you know the merge failed.
• Gitea Cleanup: Verify the .gitignore in the vault folder is correctly ignoring temporary .tmp files created during the export process.
• Staggering Review: Confirm if 5 minutes is enough buffer for the Phone to finish its push before the Tablet initiates the Merge Script.

---

## FINAL SYSTEM LOGIC (4:30 AM SEQUENCE)

1. 04:30 (Tablet): Tasker -> AutoInput (GitSync Push).
2. 04:35 (Phone): Tasker -> AutoInput (GitSync Push).
3. 04:45 (Tablet): Tasker -> HTTP Request (n8n Webhook).
4. On Success: Tasker -> Perform Task (RestoreFromMaster).

DETAILS

PROJECT: Automated JW Library Multi-Device Sync (via Gitea/n8n)

Status: In Progress (Active Debugging Phase) User Persona: INTJ (Prefers logic-first, no-fluff, technical precision)

---

1. THE ARCHITECTURE

The goal is to sync JW Library backups (.jwlibrary) across multiple Android devices using a central "Master" merge script.

• Source Devices: Android Tablet & Phone.
• Storage: Local Git "Vault" folder at /storage/emulated/0/vault.
• Git Client: GitSync (Android App).
• Remote: Self-hosted Gitea instance.
• Orchestration: n8n (running on bunny-wyvern.ts.net).
• Merge Logic: jwlFusion script on the server.

---

2. TECHNICAL HURDLES & CURRENT FIXES

• Termux Plugin Failure: The Termux:Tasker plugin failed with "Missing/Disabled Receiver" errors (likely due to Android 14 security or Play Store/F-Droid version mismatch). We abandoned Termux scripts for now.
• GitSync Intent Failure: Attempted to trigger GitSync via com.viscouspot.gitsync.action.SYNC intents, but the app did not respond to background broadcasts.
• Current Solution: Using Tasker + AutoInput. Tasker wakes the device, opens the GitSync UI, and AutoInput physically clicks "Sync" to ensure the push/pull happens.

---

3. THE DAILY TIMELINE (SCHEDULED)

• 04:30 AM (Tablet): Tasker triggers. AutoInput clicks through GitSync to push the latest local backup to its own branch on Gitea.
• 04:35 AM (Phone): Same process. Pushes its unique backup to its own branch.
• 04:45 AM (Tablet - Master Trigger):
  1. Tasker sends an HTTP POST to the n8n Webhook.
  2. n8n Workflow: * SSH into the server.
     • Pull all device branches.
     • Run jwlFusion to merge everything into master.jwlibrary.
     • Push master.jwlibrary to the master branch.
  3. Restoration: Once n8n returns 200 OK, the Tablet (and later the Phone) triggers a "Restore" task to pull the new master and import it into JW Library.

---

4. AGENT "TO-DO" LIST (FOR NEXT SESSION)

1. Refine AutoInput: Ensure the "Sync" clicks are robust (handling screen-off states or unexpected popups).
2. n8n Webhook Verification: Confirm the n8n SSH node is correctly executing the jwlFusion command and handling Git conflicts.
3. Restore Logic: Finalize the Tasker task that takes the pulled master.jwlibrary and automates the "Import" into the JW Library app.
4. Race Condition Check: Verify the 5-minute stagger between devices is sufficient for GitSync to finish its network operations.

---

5. REFERENCE DATA

• Vault Path: /storage/emulated/0/vault
• n8n Webhook: http://n8n.bunny-wyvern.ts.net:5678/webhook/sync-jw-backup
• Personality Context: User is an INTJ. Provide direct, technical solutions. No fluff.