# How to use THEOplayer with KeyOS BuyDRM
This guide explains how you set up THEOplayer in combination with the [KeyOS BuyDRM](https://www.buydrm.com/keyosplayer), a partnered **multi-DRM vendor**. THEOplayer is pre-integrated with KeyOS and provides a user-friendly API to connect to their **Widevine** and **PlayReady** DRM solutions.
If you are already comfortable with the THEOplayer API, you can go straight over to [DRM Pre-Integration API](https://docs-preview.optiview.dolby.com/pr-863/theoplayer/v10/api-reference/web/interfaces/DRMConfiguration).
## Prerequisites
This guide expects you to:
1. Have a THEOplayer license. If you aren't using THEOplayer yet, you can start your free trial [here](https://portal.theoplayer.com).
2. Be a client of KeyOS's BuyDRM, and that you are integrated with their streaming infrastructure. Information on BuyDRM can be found at .
If you can place a checkmark next to these two fields, you are good to go.
You will also need a valid THEOplayer set-up. If you have no experience with setting up our player, we have an excellent [getting started guide](https://docs-preview.optiview.dolby.com/pr-863/theoplayer/v10/getting-started/sdks/web/getting-started.md).
## Integrating KeyOS BuyDRM
Starting from the basic template above, you only need to add your BuyDRM token (=**customdata**) to your source configuration, and tell THEOplayer that you are using KeyOS.
##### Web SDK
```js
player.source = {
sources: {
src: 'your.mpd',
type: 'application/dash+xml',
drm: {
integration: 'keyos',
customdata: 'PEtleU9T...blhNTD4=',
playready: {
licenseAcquisitionURL: '',
},
widevine: {
licenseAcquisitionURL: '',
},
},
},
};
```
Your updated starting template would now look like this:
```html
THEOplayer Web SDK: Getting Started
```
##### Legacy iOS/tvOS SDK (4.12.x)
A KeyOS DRM integration is added to the source configuration by adding the keyOsDrm() parameter to drm as such:
```swift
public static var buyDRMkeyOS: SourceDescription {
let licenseAcquisitionURL: String = ""
let certificateURL: String = ""
let token: String = ""
let type: String = "application/x-mpegURL"
let src = ""
let drm: KeyOSDRMConfiguration = KeyOSDRMConfiguration(licenseAcquisitionURL: licenseAcquisitionURL, certificateURL: certificateURL, customdata: token)
let typedSource: TypedSource = TypedSource(src: src, type: type, drm: drm)
let source: SourceDescription = SourceDescription(source: typedSource)
return source
}
// Configure the player's source to initilaise playback
THEOplayer.source = buyDRMkeyOS
```
Where `token` for customdata is the Authentication XML generated from their platform.
##### Android SDK
A KeyOS DRM integration is added to the source configuration by adding the keyOsDrm() parameter to DRM as such:
```java
SourceDescription dashWithDRM = sourceDescription()
.sources(
typedSource("//sourceUrl")
.drm(
keyOsDrm()
.customdata("//token")
.playready("//playReadyKeyServer")
.widevine("//widevineKeyServer")
.build()
).build()
).build();
```
Where: `token` for customdata is the Authentication XML generated from their platform.
## Conclusion
THEOplayer partnered with KeyOS to fully pre-integrate their BuyDRM solution, saving you tons of time. This pre-integration brings along multiple advantages:
* It's very simple to set up KeyOS BuyDRM through THEOplayer.
* No surprises - you know that we are compatible with each other. We also regularly validate our integration, and are the first to know about changes to KeyOS.
* It offers extra maintainability. Even if the KeyOS infrastructure changes, we attempt to be backwards compatible.
## Extra resources:
1. [DRM Pre-Integration API](https://docs-preview.optiview.dolby.com/pr-863/theoplayer/v10/api-reference/web/interfaces/DRMConfiguration)
2. [THEOplayer Getting Started Guide](https://docs-preview.optiview.dolby.com/pr-863/theoplayer/v10/getting-started/sdks/web/getting-started.md)
3. [KeyOS BuyDRM](https://www.buydrm.com/keyosplayer)