Settings & Cache
Last updated: August 2026
App Settings Overview
Aerial TV offers a comprehensive settings menu that lets you customize the app to suit your viewing preferences. From playback behavior and caching to appearance and language, the settings screen gives you full control over how the app works across all your devices.
- Cache Management — Control how playlist data is stored and refreshed.
- Player Preferences — Choose your default video player and auto-play behavior.
- Language — Set the interface language for the app.
- Appearance — Toggle between light, dark, and system-matched themes.
- Trakt — Connect your Trakt.tv account for watch history sync, scrobbling, and recommendations.
- Analytics — Manage your data sharing preferences.
- Account & Subscription — View and manage your subscription details.
Understanding the Cache
When you load a playlist, Aerial TV caches the channel list, movie catalog, series library, and EPG (TV Guide) data locally on your device. This means the app does not need to re-download your entire playlist every time you open it, resulting in faster launch times and reduced data usage.
- Channel and category data from your M3U or Xtream Codes playlists.
- Movie and series metadata including titles, descriptions, and poster images.
- EPG (Electronic Program Guide) data for the TV Guide.
- Poster and thumbnail images for faster browsing.
Adjusting Cache Expiry
You can control how long cached playlist data is considered valid before the app automatically refreshes it from your IPTV provider. The cache expiry can be set anywhere from 1 hour to 168 hours (7 days).
- 1Go to Settings > Data & Storage.
- 2Locate the Cache Expiry setting.
- 3Use the slider or input field to set your desired expiry time in hours (1-168).
- 4The app will automatically refresh your playlist data once the cache expires.
- 1-6 hours — Best if your provider updates channels frequently or you want the freshest data.
- 12-24 hours — A good balance between freshness and performance for most users.
- 48-168 hours — Ideal for stable playlists that rarely change, minimizing data usage and load times.
Clearing the Cache
If you are experiencing issues with outdated channel listings, missing content, or incorrect EPG data, clearing the cache forces the app to re-download all playlist data from scratch.
- 1Go to Settings > Data & Storage.
- 2Tap Clear Cache.
- 3Confirm the action when prompted.
- 4The app will reload your playlists and re-download all channel, movie, series, and EPG data.
Playback Settings
Aerial TV includes a built-in video player optimized for IPTV streaming, but also supports VLC as an alternative player. You can configure these options in Settings > Playback.
- Video Player — Choose between AVPlayer (Apple's native player) or VLC. AVPlayer works well for most streams, while VLC can handle a wider range of codecs and container formats.
- Auto Play — When enabled, the app will automatically begin playing a channel or video when you select it, without requiring a separate play action.
- Incognito Mode — Watch content without adding to continue watching or recent channels. Automatically resets when the app goes to background.
- Streaming Diagnostics — Configure diagnostic mode and enable an overlay showing real-time stream information during playback.
Power User Features
Professional users and enthusiasts can take advantage of advanced features to customize their streaming experience and privacy.
- Custom User Agent — Set a custom User-Agent string for each playlist in Playlist settings. This can help bypass provider restrictions or mimic specific hardware.
- Incognito Mode — Enable this in Settings > Appearance (or relevant section) to watch content without saving to your continue watching or recent channels history. It automatically resets for privacy when the app goes to the background.
- Clean Up Titles — Automatically remove quality tags (4K, HD) and provider prefixes from movie and channel titles for a cleaner, native look.
- TVDB Metadata — Replace provider artwork with official posters and metadata from TheTVDB for a premium library experience.
Advanced Playback & Buffering
Fine-tune how Aerial TV handles video streams to optimize for your network conditions.
- Buffer Duration — Adjust the AVPlayer forward buffer to balance between quick startup and stability on slower connections.
- VLC Network Cache — Configure the network and file cache for the VLC player backend to prevent stuttering on high-bitrate streams.
- Streaming Diagnostics — Enable the diagnostic overlay during playback to see real-time technical stats like bitrate, resolution, and dropped frames.
- Auto-Play Next Episode — Seamlessly binge-watch series with configurable countdown timers between episodes.
Adjusting Cache Expiry
You can control how long cached playlist data is considered valid before the app automatically refreshes it from your IPTV provider. The cache expiry can be set anywhere from 1 hour to 168 hours (7 days).
- 1Go to Settings > Data & Storage.
- 2Locate the Cache Expiry setting.
- 3Use the slider or input field to set your desired expiry time in hours (1-168).
- 4The app will automatically refresh your playlist data once the cache expires.
- 1-6 hours — Best if your provider updates channels frequently or you want the freshest data.
- 12-24 hours — A good balance between freshness and performance for most users.
- 48-168 hours — Ideal for stable playlists that rarely change, minimizing data usage and load times.
Language, Analytics, and Appearance
Aerial TV supports multiple interface languages, offers privacy-respecting analytics options, and lets you choose your preferred visual theme.
- Language — Select your preferred language for the app interface. The app supports a wide range of languages and the change takes effect immediately.
- Analytics — You can opt in or out of anonymous usage analytics. When enabled, Aerial TV collects anonymized data about feature usage to help improve the app. No personal information or viewing history is ever collected.
- Appearance — Choose from Light, Dark, or System theme. The System option follows your device's current appearance setting, switching automatically between light and dark modes.