# Troubleshooting Guide

Having technical issues with Tara? Find solutions to common problems below.

---

## Audio Issues

### No sound during meditation

**Quick fixes:**

1. Check that your device isn't on silent mode
2. Turn up your device volume
3. Make sure headphones are connected properly (if using)
4. Check that Tara has audio permissions

**Device settings to check:**

- **iOS**: Settings > Tara > Allow Audio
- **Android**: Settings > Apps > Tara > Permissions > Microphone

**Still no sound?**

- Try a different meditation to rule out a specific file issue
- Close other apps that might be using audio
- Restart your device

### Audio is choppy or stuttering

**Possible causes and fixes:**

| Cause                 | Solution                               |
| --------------------- | -------------------------------------- |
| Slow internet         | Switch to WiFi or download for offline |
| Low streaming quality | Settings > Playback > High Quality     |
| Background apps       | Close other apps using network         |
| Device storage low    | Free up storage space                  |
| Outdated app          | Update to the latest version           |

### Audio cuts out when phone locks

**iOS:**

1. Tara should play in the background by default
2. Check: Settings > Tara > Background App Refresh (enable)
3. Disable "Low Power Mode" if enabled

**Android:**

1. Go to Settings > Apps > Tara > Battery
2. Select "Unrestricted" or "Don't optimize"
3. Disable battery saver during meditation

### Background sounds not working

1. Make sure you have Premium (background sounds are a Premium feature)
2. Check that the background sound volume isn't at zero
3. Some meditations don't support background sounds (check the sound icon)
4. Try a different background sound

---

## App Crashes & Freezing

### App crashes on startup

1. **Force close and restart:**
   - iOS: Double-tap home button, swipe Tara up
   - Android: Recent apps button, swipe Tara away

2. **Restart your device** - This clears temporary issues

3. **Update the app:**
   - iOS: App Store > Updates
   - Android: Play Store > My apps

4. **Clear app cache (Android only):**
   - Settings > Apps > Tara > Storage > Clear Cache

5. **Reinstall the app:**
   - Delete Tara from your device
   - Reinstall from your app store
   - Log back in (your progress is saved)

### App freezes during meditation

1. Wait a moment - the app may be buffering
2. Check your internet connection
3. If frozen, force close and restart the app
4. Download meditations for more reliable playback

### App is very slow

1. Close other apps running in background
2. Free up device storage (need at least 500MB free)
3. Restart your device
4. Check for app updates
5. Reinstall if problem persists

---

## Login & Account Issues

### Can't log in

**Check your credentials:**

- Make sure you're using the correct email
- Try resetting your password
- Check for typos in email address

**If using social login:**

- Make sure you're signing in with the same method you registered with
- iOS: Settings > Sign in with Apple > Tara (if issues)
- Google: Check that your Google account is active

**Still can't log in?**

- Check your internet connection
- Try logging in on WiFi instead of cellular
- Contact support with your email address

### "Account not found" error

This usually means:

- You're using a different email than you registered with
- You may have signed up with a different method (Apple/Google vs email)
- Your account may have been deleted

**Solution:** Try all login methods (email, Apple, Google) with all email
addresses you use.

### "Invalid credentials" error

1. Make sure Caps Lock is off
2. Reset your password using "Forgot Password"
3. Clear app cache and try again
4. If using a password manager, try typing manually

### Session keeps expiring

1. Make sure your device clock is set to automatic
2. Check your internet connection
3. Log out and log back in
4. Update to the latest app version

---

## Subscription Issues

### I subscribed but still see free content only

1. **Restore purchases:**
   - Go to Settings > Subscription > Restore Purchases
   - Wait for confirmation

2. **Check your account:**
   - Make sure you're logged into the same account you purchased with
   - Check which email is shown in Settings > Account

3. **Verify the purchase:**
   - iOS: Settings (phone) > Apple ID > Subscriptions
   - Android: Play Store > Subscriptions

4. **Wait a moment:**
   - Sometimes it takes a few minutes for subscription to activate
   - Try closing and reopening the app

### Subscription shows active but Premium isn't working

1. Force close and restart the app
2. Log out and log back in
3. Restore purchases in Settings > Subscription
4. Check your internet connection (subscription verified online)

### I was charged twice

You likely have multiple subscriptions or a timing issue:

1. Check both app stores for active subscriptions
2. Contact Apple Support or Google Play Support for refunds
3. Cancel any duplicate subscriptions

### My free trial ended early

Free trials are 7 days from first activation. Check:

- Trial start date in Settings > Subscription
- You may have had a previous trial on another account
- Contact support if you believe there's an error

---

## Sync & Progress Issues

### Progress not syncing between devices

1. **Check accounts:**
   - Make sure you're logged into the same account on all devices

2. **Force sync:**
   - Settings > Account > Sync Now
   - Give it a few minutes

3. **Check internet:**
   - Both devices need internet connection
   - Try on WiFi

4. **Update apps:**
   - Make sure all devices have the latest app version

### My practice rhythm changed

Your practice rhythm may look different because:

- A practice day rolled over without a completed session
- Time zone setting was incorrect
- Device was offline and couldn't sync

**To keep the view aligned:**

- Set your correct time zone: Settings > Account > Time Zone
- Enable grace days (Premium feature)
- Practice before midnight when you want the same local day counted

**If you believe it's an error:** Contact support with:

- Your email address
- What your practice rhythm showed
- The date it changed

### Meditations marked as not completed

1. Meditations must play to at least 80% to count as "completed"
2. Pausing and resuming later still counts
3. Make sure you were online at the end (for sync)
4. Check Settings > Account > Sync Now

---

## Download Issues

### Can't download meditations

1. **Check Premium status:**
   - Downloads require Premium subscription
   - Settings > Subscription

2. **Check storage:**
   - You need free space (about 50MB per meditation)
   - iOS: Settings > General > iPhone Storage
   - Android: Settings > Storage

3. **Check connection:**
   - Download on WiFi for best results
   - Pause and resume if download stalls

4. **App permissions:**
   - Make sure Tara can access storage

### Downloads not playing offline

1. Make sure the download completed (shows checkmark, not loading)
2. Find downloads in Library > Downloads
3. Some downloads may expire - re-download if needed
4. Restart the app while offline

### Downloads taking too long

1. Switch to WiFi if on cellular
2. Move closer to your router
3. Try downloading one at a time instead of multiple
4. Restart your download

---

## Notification Issues

### Not receiving daily reminders

**Check app settings:**

1. Settings > Notifications > Daily Reminder (should be ON)
2. Make sure a time is set
3. Check which days are selected

**Check device settings:**

_iOS:_

1. Phone Settings > Notifications > Tara
2. Allow Notifications: ON
3. Check notification style settings

_Android:_

1. Phone Settings > Apps > Tara > Notifications
2. All notifications should be enabled
3. Check battery optimization isn't blocking notifications

**Other checks:**

- Make sure "Do Not Disturb" is off at reminder time
- Focus modes (iOS) might be blocking notifications
- Battery saver modes can block notifications

### Receiving too many notifications

1. Settings > Notifications
2. Disable notification types you don't want:
   - Daily Reminder
   - New Content
   - Streak Warnings
   - Tips & Recommendations

---

## Performance Issues

### App using too much battery

1. **Reduce background activity:**
   - Close app when not meditating
   - Disable background refresh if not needed

2. **Download instead of stream:**
   - Streaming uses more battery than playing downloads

3. **Check for app updates:**
   - Bug fixes often improve battery usage

### App using too much storage

1. **Clear downloaded meditations:**
   - Library > Downloads > Edit > Delete

2. **Clear cache (Android):**
   - Phone Settings > Apps > Tara > Storage > Clear Cache

3. **Limit downloads:**
   - Only keep favorites downloaded
   - Delete after listening

### App using too much data

1. **Download on WiFi:**
   - Settings > Playback > Download Over WiFi Only

2. **Lower streaming quality:**
   - Settings > Playback > Streaming Quality > Standard

3. **Use offline mode:**
   - Download meditations when on WiFi
   - Listen offline to save data

---

## Quick Reference: Error Messages

| Error                    | Meaning            | Solution                |
| ------------------------ | ------------------ | ----------------------- |
| "Network error"          | No internet        | Check WiFi/cellular     |
| "Session expired"        | Login needed       | Log in again            |
| "Subscription not found" | Purchase issue     | Restore purchases       |
| "Download failed"        | Storage or network | Check space, try WiFi   |
| "Playback error"         | Audio issue        | Restart app, redownload |
| "Sync failed"            | Server connection  | Try again later         |

---

## Contact Support

If you've tried the above solutions and still have issues:

**Email:** support@tara.app

**Include:**

- Device type and OS version (e.g., iPhone 14, iOS 17.2)
- App version (Settings > About)
- Description of the problem
- Steps you've already tried
- Screenshots if helpful

**Response time:** Within 24-48 hours

---

## Report a Bug

Found a bug? Help us fix it:

1. Go to Settings > Help > Report a Bug
2. Describe what happened
3. Include steps to reproduce
4. Attach screenshots or screen recording if possible

We appreciate your help in improving Tara!
