Gida TV App Support

Getting Started

What is Gida TV?

Gida TV is a premium IPTV player for Apple TV (tvOS 26+) that supports M3U playlists and Xtream Codes API. It's a player-only application that allows you to watch your legally-authorized IPTV streams with features like favorites, recently viewed, iCloud sync, and multi-playlist management.

How do I add a new M3U or Xtream playlist?

Go to Settings → Add Playlist, then paste your playlist URL using the on-screen keyboard or your device. For Xtream Codes, you'll need to provide the server URL, username, and password. Only valid M3U, M3U8, or Xtream URLs are accepted.

What are the system requirements?

Gida TV requires tvOS 26.0 or later and runs on Apple TV 4th generation or newer. An active internet connection is required for streaming, and iCloud is optional for syncing favorites and playlists across devices.

Subscription & Trial NEW

How does the 7-day free trial work?

New users get a 7-day free trial with 24 hours of cumulative usage time. The trial period expires after 7 days OR after using 24 hours of playback time, whichever comes first. No credit card required during the trial.

What happens after the trial expires?

After your trial expires, you'll need to subscribe to continue using the app. We offer monthly and yearly subscription options via in-app purchase. Your playlists and settings are preserved when you subscribe.

What subscription plans are available?

We offer two subscription options: Monthly and Yearly. Both plans include unlimited playlists, all premium features, iCloud sync, and priority support. Subscriptions are managed through your Apple ID and can be cancelled anytime.

How do I manage my subscription?

Go to Settings on your Apple TV → Users & Accounts → [Your Account] → Subscriptions. You can view, modify, or cancel your subscription from there. Changes take effect at the end of the current billing period.

Playlist Management

Can I use multiple playlists simultaneously?

Yes! Gida TV supports multiple M3U and Xtream playlists. You can switch between playlists from the main menu, and favorites work across all playlists.

How do I refresh my playlist?

Playlists automatically refresh based on their cache expiration setting (default: 30 minutes). You can also manually refresh from Settings → Refresh Playlists, or use the refresh button in the playlist view.

Does Gida TV store or share my playlist data?

No. Playlists are stored locally on your device or in your personal iCloud account if sync is enabled. We do not collect, store, or share your playlist URLs, credentials, or viewing data. See our Privacy Policy for details.

Why are some channels missing or not playing?

Channels may be missing due to: (1) Offline or inactive streams, (2) Geo-restrictions, (3) Authentication requirements, or (4) Server-side issues. The app relies on content provided by your playlist provider.

Playback & Streaming

What video formats are supported?

Gida TV supports HLS streams (.m3u8), MPEG-TS, and MP4 formats via AVFoundation/AVKit. It also supports Clear Key DRM for protected content. Unsupported formats may not play correctly.

Why do I see buffering or playback errors?

Buffering can be caused by: (1) Slow internet connection, (2) Network congestion, (3) Server-side issues, or (4) Stream quality exceeding your bandwidth. Try switching networks or contacting your IPTV provider.

How does channel preloading work?

For Xtream playlists, you can enable channel preloading in Settings. This loads channel details in advance for faster switching. Note: Preloading uses more bandwidth and respects the max connections limit from your provider.

Can I use DRM-protected streams?

Yes, Gida TV supports Clear Key license for DRM-protected content. The license information must be included in your playlist metadata.

iCloud Sync & Storage

How does iCloud sync work?

When enabled, Gida TV syncs your playlists, favorites, and recently viewed content across all your devices via iCloud. Changes sync automatically when connected to internet.

iCloud Sync Not Working?

Ensure: (1) iCloud is enabled in Settings → Apple ID → iCloud, (2) The app has iCloud Document & Data permissions, (3) You're signed in to the same Apple ID on all devices, (4) You have sufficient iCloud storage available.

How can I favorite or organize channels?

Long press on any channel to add it to favorites. Access favorites from the sidebar menu. Favorites sync across all your playlists and devices (with iCloud enabled).

How do I clear app cache?

Go to Settings → Refresh Playlists to clear cached playlist data. This will not delete your playlists or settings. For complete cache clearing, go to Settings → Cache Management.

Troubleshooting

M3U Playlist Not Loading

Verify: (1) URL is accessible and uses HTTPS, (2) Playlist format follows M3U8 specifications, (3) URLs contain proper #EXTINF tags, (4) No firewall blocking access.

Xtream API Connection Issues

Check: (1) Server URL is correct (no trailing slash), (2) Username and password are accurate, (3) Your IPTV subscription is active, (4) Server is not under maintenance.

App crashes or freezes

Try: (1) Force quit and restart the app, (2) Clear cache in Settings, (3) Restart your Apple TV, (4) Update to the latest app version. If issues persist, contact support with crash details.

Performance issues with large playlists

For playlists with 1000+ channels: (1) Enable caching for faster loads, (2) Use category filtering, (3) Consider splitting into multiple smaller playlists, (4) Ensure sufficient Apple TV storage space.

Is my data secure?

Yes. All data is stored securely on your device or in your personal iCloud account with end-to-end encryption. We do not transmit your playlists, credentials, or viewing data to external servers.