settings

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.
lightbulb
Tip: Settings are stored locally on each device by default. Subscribe to the Family plan and enable Cloud Sync to keep your settings consistent across all devices. Connect Trakt in Settings to sync your watch history with Trakt.tv. Learn more

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.
info
Note: The cache only stores metadata and images — it does not store video content. Streams are always loaded live from your IPTV provider.

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).

  1. 1Go to Settings > Data & Storage.
  2. 2Locate the Cache Expiry setting.
  3. 3Use the slider or input field to set your desired expiry time in hours (1-168).
  4. 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.
lightbulb
Tip: If your provider has recently added or removed channels and you are not seeing the changes, try lowering the cache expiry or manually clearing the cache.

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.

  1. 1Go to Settings > Data & Storage.
  2. 2Tap Clear Cache.
  3. 3Confirm the action when prompted.
  4. 4The app will reload your playlists and re-download all channel, movie, series, and EPG data.
warning
Warning: Clearing the cache will cause the app to re-download all playlist data on the next launch, which may take a few moments depending on the size of your playlists and your internet connection speed.

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.
lightbulb
Tip: If you experience playback issues with certain channels and you are on iOS/tvOS, try switching to VLC in Settings > Playback > Player Preference. VLC has broader codec support and can often play streams that the built-in player cannot.

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.
lightbulb
Tip: You can also manage which categories are visible for Channels, movies, and series in Category Management. Use PIN protection to hide specific adult or sensitive categories.

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.
lightbulb
Tip: If you experience frequent buffering on iOS/tvOS, try increasing the "Forward Buffer Duration" or "VLC Network Cache" in Settings > Playback.

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).

  1. 1Go to Settings > Data & Storage.
  2. 2Locate the Cache Expiry setting.
  3. 3Use the slider or input field to set your desired expiry time in hours (1-168).
  4. 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.
lightbulb
Tip: If your provider has recently added or removed channels and you are not seeing the changes, try lowering the cache expiry or manually clearing the cache.

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.
info
Note: Language settings apply to the Aerial TV interface only. Channel names, EPG data, and content descriptions come from your IPTV provider and are displayed in whatever language they provide.