Attunement Troubleshooting & FAQ

Solutions and diagnostic steps for issues encountered while accessing or operating ToFF Attunement.

---

1. Mobile App Sign-In Issues

Symptom: "Network Error" or "Unable to Connect"

• Root Cause: The mobile app defaults to a generic cloud endpoint if the institutional server address is not entered.
• Resolution:
  1. Return to the initial sign-in screen.
  2. Tap the Server Address field underneath the sign-in button.
  3. Ensure it is set exactly to:

     https://listen.tomoffinland.org

  4. Ensure there are no trailing spaces or misspellings.
  5. Re-enter your institutional email and password, then tap Sign In.

---

2. iOS Share Sheet Issues

Symptom: KaraKeep does not appear in the iOS Share Sheet

• Root Cause: KaraKeep was not pinned to your Favorites row in iOS.
• Resolution:
  1. Open Photos or Safari and tap the Share icon.
  2. In the top app row, scroll all the way to the right and tap More (...).
  3. Tap Edit in the top-right corner.
  4. Find KaraKeep under Suggestions / Other Apps and tap the green + icon to add it to Favorites.
  5. Tap Done. KaraKeep will now permanently remain in your primary sharing row.

---

3. Forward-to-Keep Gateway Issues

Symptom: Forwarded email does not appear in the dashboard

• Check 1: Expected Polling Window: The background ingestion worker checks incoming emails every 30 to 60 seconds. Wait at least 60 seconds after dispatch.
• Check 2: Workspace Filter: Forwarded emails are partitioned directly into the Board Members Only workspace. Ensure you click Board Members Only in the left navigation sidebar.
• Check 3: Authorized Sender Whitelist: For security against unauthorized submissions, emails should be sent from your official @tomoffinland.org account. If you forwarded from an external personal address, contact Administrator Nolan to add your address to the authorized whitelist.

---

4. Video Download & Preservation Failures

Symptom: Video asset shows an error card instead of a player

• Private Accounts: yt-dlp cannot download media from private or password-protected Instagram / X accounts. Only publicly accessible media can be preserved automatically.
• Alternative Workflow: For private posts or disappearing media, capture a screen recording or high-resolution screenshot on your mobile device, then ingest the image/video file directly using Mode 2 (Direct High-Resolution Local Media Ingress).