THEO DOCS
MANAGE YOUR OWN ONLINE VIDEO PLAYER
THEO Docs was created to help you integrate your THEOplayer from start to finish. Explore our easy to follow step-by-step guides for Advanced Features, Add Ons, and API References to get the most from your player. THEO Docs is your one-stop shop for everything THEOplayer.
Getting started
THEOplayer offers a rich portfolio of video SDKs. Our dedicated guides help you get started right away.
Frameworks
The THEOplayer SDK can be integrated in a various set of today's popular frameworks.
API references
Discover all properties and functions of THEOplayer while reading our API references.
Getting Started
SDKs
IntroductionHow to update an SDK?THEOplayer 5.0 - Native Mobile iOS/tvOS and Android SDKs
Web
Getting started on Web (Extended)Getting started with the new Web UIGetting started on WebAPI examplesHow to implement Keyboard HotkeysHow to embed an iframeHow to implement a seamless transition between videos?How to work around browser cache with new THEOplayer SDK libraries?How to customise quality selection & labels (MP4)How to get frame-accurate currentTime display in the UI Control barHow to play an LCEVC source with THEOplayerHow to use WebXR with THEOplayerHow to use THEOplayer as a JavaScript moduleAndroid legacy (4.12.x)
Getting started on Legacy Android SDK (4.12.x)Legacy Android SDK (4.12.x) customizationHow to couple the native MediaRouteButton to THEOplayerHow to enable experimental native rendering on AndroidHow to do offline Playback with AES-128 Encrypted Streams on AndroidAndroid
Getting started with the Android UIGetting started on AndroidAndroid Feature IntegrationsMigration from THEOplayer Android/AndroidTV/FireTV SDK 4.x to THEOplayer Android SDK 5.0iOS legacy (4.12.x)
Getting started on iOSiOS/tvOS SDK and Legacy iOS/tvOS SDK (4.12.x) CustomizationMy app does not want to build for the app storeHow to bypass copy() not working in Safari consoleHow to couple the native GCKUICastButton to THEOplayeriOS/tvOS SDK and Legacy iOS/tvOS SDK (4.12.x) Touch-events (gestures)Building for iOS Simulator, but the linked and embedded framework THEOplayerSDK.framework was built for iOS + iOS SimulatorHow to implement custom local network access (LNA) interstitial dialog for ChromecastiOS
Getting started guide for THEOplayer iOS/tvOS SDK 5.0THEOplayer iOS/tvOS 5.0 Feature IntegrationsMigration from THEOplayer iOS and tvOS SDK 4.x to THEOplayer iOS/tvOS SDK 5.0+Android TV Legacy (4.12.x)
Getting started on Android TV Legacy (4.12.x)tvOS
Getting started on tvOSChromecast
Getting started on ChromecastChromecast Application CustomizationWebos
Getting Started on webOSTizen
Getting started on TizenInstalling the Tizen developer toolsSetting up a Tizen device for debuggingDeploying a test app on a physical Tizen deviceDeploying a test app on a Tizen emulatorRoku
Getting Started on RokuFire TV Legacy (4.12.x)
Getting started on Fire TV Legacy (4.12.x)Frameworks
Knowledge Base
Advertisement
Content Protection
Playback
IntroductionWhat are chapter markers?What are the benefits of preview thumbnails?Frame Accurate SeekingProgram Date TimeBasic guide to Web Audio APIVideo Clipping
Titles and closed captions
IntroductionChapter markersStreaming
CORS
Metadata
FAQ
IntroductionHow to add CSS or JavaScript files to an Android/iOS projectHow to combat autoplay policiesWhy does fullscreen not behave as expected on iOSWhy does the Network API not work on iOS devicesWhy does Chromecast not work on iOS Chrome?Why can't I select another video quality on iOS/tvOS?Is YouTube supportedWhy does the player load only one audio track (even though there are several in the manifest)Is it possible to see 360 degrees photo with THEOplayerWhy the Visibility API does not work through an iframe on Safari and IE11What is an impressionHow to know whether a live stream is playingWhich error related events does the player exposeWhy did my subtitles stop workingHow does Media Engagement Index (MEI) affect Autoplay on ChromeWhat does the error message 'Unknown CDM error' meanWhat does the error message 'Something went wrong with Native playback' meanWhy are not all response headers exposedWhy does the currentTime seem off in my livestream & what can I do about itHow to remove CORS restrictions from a reproduction streamWhich network calls (or requests) does THEOplayer doWhy does the playback not work when using the Chrome iPhone/iPad simulatorWhat does the error message 'can only be initiated by a user gesture' imply? Can I still force the desired actionHow to remove unwanted CC track in iOS or SafariWhy do I get a gray play button in my Android WebView and how to remove it?MediaTek limitationsHow to use ProGuard with THEOplayer Android SDKSelf-hosting and versioning of THEOplayerDoes THEOplayer support EXT-X-DATERANGECan clipping be used on a playlistCan timeline thumbnails be made available before playback startWhat are the benefits of preloadingWhat are the player seeking and seeked events and when are they firedCan we use HLS or DASH adsHow to change text in THEOplayerChange text when AirplayingITP2.1 problems using THEOplayerRemoving context menu/'Powered by THEOplayer v2...'What aspects of THEOplayer do we need to take into account to deploy a proper Content Security Policy (CSP)How can we avoid that the player keeps looking for chunks/segments if they are not foundCan we show a custom message on 403 on mp4Can we prevent UpNext feature from redirectingIs it possible to preload VOD content while the pre-roll is playingWhy is my video not playing automaticallyIs it possible to have multiple player instances play at the same timeIs it a problem if the viewer pauses a live stream for longer than the DVR windowTHEOplayer Features & ModulesChromecast on my webplayer does not work any longer despite no change in my implementationHow to track network errorsWhat is the support for WowzaHow to use the CDN fallback/backup stream featureHow to apply accurate buffering strategyHow can I distribute 4K content?What is the collaboration between Azure Media Services and THEOplayerIs Portrait mode supportedHow to prevent screen recordingThe provided video source is incompatible with the license for this playerPage and Source domainsWhat does the error message “Something went wrong determining the initial period of the provided MPEG-DASH stream” meanWhy is my PlayReady stream not working in Chromium Edge?Which subtitle and CC formats are supported on native SafariHow to navigate through the documentation and resourcesHow to create a (great) ticketHow to investigate a ticketWhat are the limitations of AirPlayWhat are the Edgio challengesHow to use the Media Session APIHow to use THEOplayer iOS SDK on an M1 macWidevine CDM deprecation notice for old browser versions
How-to-Guides
Ads
IntroductionAdblock detectionCustomizing the ad overlay textHow to set up VAST and VMAP ads?YospaceHow to display visual cues on the timeline to mark mid-rolls?FreeWheelSpotXGoogle Dynamic Ad Insertion (DAI)Prebid.jsGoogle IMAHow to subscribe to ad eventsMediaTailor
Analytics
IntroductionMoatMuxYouboraAgamaCustom Analytics IntegrationAdobe AnalyticsMediaMelon SmartSightWicket LabsTealiumSegment
Conviva
IntroductionConviva Connector for VideoAnalytics & AdsAnalyticsCast
Chromecast
IntroductionConnecting from custom Sender applicationsDebuggingHow to configure a different stream to ChromecastSending messages from/to Sender to/from ReceiverPass subtitle selection on to ChromecastEnable Chromecast on the SenderAirplay
IntroductionDRM
IntroductionArris TitaniumAxinomComcastEZDRMIntertrust ExpressPlayIrdetoMicrosoft AzureNagra Conax ContegoVerimatrix MultiRightsVimondVualto VuDRMVerizon UplynkXstreamHow to play a Clear Key protected stream in THEOplayer?PallyConMulti-key HLS
BuyDRM KeyOS
IntroductionHow to use THEOplayer with KeyOS BuyDRMcastLabs DRMToday
IntroductionHow to do offline Playback with DRMToday on iOSHow to do offline DRM
IntroductionHow to do offline DRM on AndroidHow to do offline DRM on iOS/tvOS SDK and Legacy iOS/tvOS SDK (4.12.x)Customizing Notifications for Downloading Offline DRM on AndroidIntegrations
IntroductionIRIS.TVStreamrootWowza streaming engine with secure token version 2Deliver Low-Latency HLS live streams using Wowza Streaming Engine and THEOplayer
Mediatrack
IntroductionHow to programmatically enable or disable audio tracksHow to programmatically detect audio tracksHow to programmatically select a video track qualityHow to programmatically detect video track qualitiesHow to start with a specific quality?How to reduce data usage on mobile devices on mobile webHow to programmatically detect video track quality changesHow to programmatically detect audio track changes
Miscellaneous
IntroductionRelated ContentSocial SharingUp NextVRWeb AudioClippingPicture-in-PictureUsing hlsDateRange propertyPreloadingSaving the progress of a caching task in iOS
Context Menu
IntroductionHow can we disable the right click?How to change the context menuVerizon Media
IntroductionPreplayVerizon Media AdsPingVerizon Media ConfigurationVerizon Media InterfaceError
IntroductionHow to do error handlingError codesNetwork
Player
IntroductionHow do you know when a stream or an advertisement is playing?How to measure time-to-first-frame?How can we track the first play(ing) event?How to track player states
Texttrack
IntroductionHow to dynamically change the visible captions?How to programmatically detect text tracksHow to programmatically enable or disable text tracksHow to insert subtitles?How to implement preview thumbnails in THEOplayerHow to track ID3 cues / tags?How to programmatically detect text track changesHow to detect active text track cues
UI
IntroductionIs it possible to remove an element from the UI?How to align the timeline in the middleHow to change the Big Play Button?How to make the control bar always visible?Is it possible to hide/disable the Google IMA UI?How to build a Chromeless UIHow to insert a buttonHow to change the default UI language to otherCustomize UI during ad playbackHow to change how a video should be fit inside a containerHow to make an audio-only playerCustomizing the UI: vertical volume sliderUI SkinningHow to detect the visibility of the default control barHow to disable click to pause
License
Objective C
Make sure to follow us on GitHub!
Copyright © 2022. All Rights Reserved.
Leuven
New York
Singapore
Barcelona