Extract Widevine L3 keys from Android devices effortlessly, spanning multiple Android versions for DRM research and education.
 
 
Go to file
hyugogirubato c2f5264b04 Update cdm.py
- wvd output name look like original repo
2024-05-28 19:59:47 +02:00
docs Release v1.0.7 2024-05-12 15:34:11 +02:00
extractor Update cdm.py 2024-05-28 19:59:47 +02:00
.gitignore Release v1.0.2 2024-03-31 15:27:10 +02:00
CHANGELOG.md Update CHANGELOG.md 2024-05-22 18:49:14 +02:00
LICENSE Initial commit 2024-03-30 17:16:13 +01:00
README.md Update README.md 2024-05-22 18:37:22 +02:00
keydive.py Added autostart error message 2024-05-22 19:09:40 +02:00
requirements.txt Update dependencies 2024-05-22 18:35:58 +02:00

README.md

KeyDive: Widevine L3 Extractor for Android

KeyDive is a sophisticated Python script designed for the precise extraction of Widevine L3 DRM (Digital Rights Management) keys from Android devices. This tool leverages the capabilities of the Widevine CDM (Content Decryption Module) to facilitate the recovery of DRM keys, enabling a deeper understanding and analysis of the Widevine L3 DRM implementation across various Android SDK versions.

[!IMPORTANT]

Support for Android 14+ (SDK > 33) require the use of functions extracted from Ghidra.

Features

  • Automated extraction of Widevine L3 DRM keys.
  • Compatibility with a wide range of Android versions (SDK > 22), ensuring broad applicability.
  • Seamless extraction process, yielding essential DRM components such as the client_id.bin for device identification and the private_key.pem for the RSA private key.

Prerequisites

Before you begin, ensure you have the following prerequisites in place:

  1. ADB (Android Debug Bridge): Make sure to install ADB and include it in your system's PATH environment variable for easy command-line access.
  2. Frida-Server: Install frida-server on your target Android device. This requires root access on the device. For installation instructions and downloads, visit the official Frida documentation.
  3. Python Requirements: KeyDive requires specific Python libraries to function correctly. Install them using the provided requirements.txt file:
    pip install -r requirements.txt
    

Installation

Follow these steps to set up KeyDive:

  1. Ensure all prerequisites are met (see above).
  2. Clone this repository to your local machine.
  3. Navigate to the cloned directory and install the required Python dependencies as mentioned.

Usage

  1. Play a DRM-protected video on the target device.
  2. Launch the KeyDive script.
  3. Reload the DRM-protected video on your device.
  4. The script will automatically extract the Widevine L3 keys, saving them as follows:
    • client_id.bin - This file contains device identification information.
    • private_key.pem - This file contains the RSA private key.

This sequence ensures that the DRM-protected content is active and ready for key extraction by the time the KeyDive script is initiated, optimizing the extraction process.

Offline Extraction Process

For situations where internet access is limited or unavailable, KeyDive supports an offline extraction mode. This mode allows for the extraction of DRM keys without an active internet connection. Follow these steps to prepare:

  1. Prepare the Android Device:

    • Install all necessary dependencies and tools while connected to the internet. Ensure that all software and libraries required by KeyDive are properly configured on the device. This includes making sure the device is fully prepared to handle DRM extraction in an offline environment.
  2. Execute KeyDive in Offline Mode:

    • Once all the preparations are complete and the device is disconnected from the internet, run the KeyDive script to extract the Widevine L3 keys. Ensure that the DRM-protected content is ready and available on the device for extraction.

For a detailed step-by-step guide on setting up and executing KeyDive without internet access, please refer to our dedicated document: Offline Mode Detailed Guide.

Command-Line Options

usage: keydive.py [-h] [-a] [-d DEVICE] [-f FUNCTIONS] [-w] [--force]

Extract Widevine L3 keys from an Android device.

options:
  -h, --help            show this help message and exit
  -a, --auto            Open Bitmovin's demo automatically.
  -d DEVICE, --device DEVICE
                        Target Android device ID.
  -f FUNCTIONS, --functions FUNCTIONS
                        Path to Ghidra XML functions file.
  -w, --wvd             Generate WVD.
  --force               Force using the default vendor (skipping analysis).

Extracting Functions for Advanced Usage

For advanced users looking to use custom functions with KeyDive, a comprehensive guide on extracting functions from Widevine libraries using Ghidra is available. Please refer to our Functions Extraction Guide for detailed instructions.

Temporary Disabling L1 for L3 Extraction

Some manufacturers (e.g., Xiaomi) allow the use of L1 keyboxes even after unlocking the bootloader. In such cases, it's necessary to install a Magisk module called liboemcrypto-disabler to temporarily disable L1, thereby facilitating L3 key extraction.

Credits

Special thanks to the original developers and contributors who have made KeyDive possible. This tool is the culmination of collaborative efforts, research, and a deep understanding of DRM technologies.

Disclaimer

KeyDive is intended for educational and research purposes only. The use of this tool in unauthorized testing of protected content is strictly prohibited. Please ensure you have permission before proceeding with DRM key extraction.


By using KeyDive, you acknowledge and agree to the terms of use and disclaimer stated above.