**Here's a complete, step-by-step IPTV troubleshooting guide** for when channels aren't working (no channels load, buffering, black screen, login failures, etc.). This covers the most common issues for services like **Your Mama IPTV**, **Crystal Clear XCIPTV**, **TV Watchers**, and apps such as XCIPTV, Smarters Pro, TiviMate, etc.

Start from the top and work your way down. Many issues are resolved in the first few steps.

### 1. Quick Basic Checks (Most Common Fixes)
- **Verify your subscription is active**: Log into your provider portal (or check your account in the app) to confirm the subscription hasn't expired, credits are available, and your line/device isn't blocked or limited to one connection.
- **Restart everything**:
1. Power off your streaming device (Fire Stick, Android box, Smart TV, phone, etc.).
2. Unplug your router/modem for 60 seconds.
3. Plug router back in, wait for full internet, then restart the device.
- **Test internet connection**:
- Run a speed test (aim for 10+ Mbps for HD, 25+ Mbps for 4K).
- Try loading YouTube or another streaming app in high quality.
- Switch between Wi-Fi and mobile hotspot (or wired Ethernet) to rule out your ISP.

### 2. App-Specific Troubleshooting
- **Clear app cache and data** (fixes most loading/glitch issues):
- Go to device **Settings > Apps > [Your IPTV App] > Storage > Clear Cache** (then Clear Data if needed).
- For XCIPTV: Also check permissions (Storage, Network) and reset defaults.
- Force stop the app, then relaunch and log in again.
- **Re-enter login details**:
- Double-check username, password, and portal/playlist URL (no extra spaces).
- Log out and log back in. Try re-adding the M3U/Xtream Codes playlist.
- **Update or reinstall the app**:
- Check for updates in the app store or your APK source (e.g., apkmarket.xyz for custom builds).
- Reinstall if issues persist (back up settings if possible).
- **Check device date/time**: Set to automatic.
- **Test in another app**: If it works in one player but not another, the issue is app-specific.

### 3. Network and Connection Issues
- **Try a VPN** (often resolves ISP blocking/throttling):
- Use a reliable VPN (e.g., Proton VPN free tier mentioned by users) and connect to a nearby server.
- Test without VPN first, then with it.
- **Change DNS**:
- Set DNS to 8.8.8.8 (Google) or 1.1.1.1 (Cloudflare) in router or device settings.
- **Reduce load**: Disconnect other devices from your network. Avoid peak hours if possible.
- **Check for firewall/router restrictions**: Temporarily disable any security features.

### 4. Specific Problems and Fixes
- **No channels load / Stuck on loading**:
- Usually provider-side (server overload) or bad playlist. Contact support or wait a bit. Test VOD/movies to isolate.
- Re-add playlist or try a different device.
- **Buffering / Freezing** (even with good speed):
- Lower video quality in app settings.
- Change player settings (e.g., decode method: Hardware vs Software).
- Use VPN or different server. Clear cache again.
- **Black screen / No signal / No audio**:
- Try a different channel.
- Power cycle device + router.
- Check subscription status (expired subs often show this).
- **Login / Authentication failed**:
- Wrong credentials or expired account.
- Multiple devices logged in simultaneously (if limited connections).
- **EPG / Guide not working**:
- Re-enter EPG URL, clear cache, or wait for update.

### 5. Provider-Side / Advanced Checks (For You as the Owner)
- Log into your **1-Stream panel** (or equivalent) and check:
- User status, connections, expiry.
- Server load / streaming tools / logs.
- Recent changes to streams or transcoding profiles.
- Review server resources (storage, bandwidth).
- Check for maintenance/outages on your end.
- Test the playlist URL directly in a browser or another tool.
- For custom APKs: Verify rebranding (API/DNS/logos) and rebuild if needed.

### 6. If Nothing Works
- Test on a **different device/network** (e.g., phone on mobile data).
- Contact your IPTV provider support (for Your Mama IPTV / TV Watchers, reach out via Discord or ticket — 24/7 owner support is a selling point!).
- Provide details: App name/version, device, error message, what you've tried.

**Pro Tips for Your Customers**:
- Use wired connection when possible.
- Keep apps and firmware updated.
- Avoid cheap/low-spec devices for 4K/high-channel-count.
- For your business: Include this guide in welcome emails, Discord, or your forum (tvwatchers.xyz/community).

This covers 95%+ of issues based on common reports. If you're seeing a specific error on your services or a particular app/panel, share more details for tailored steps!