KeyDive/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.1.2] - Not released

Added

• Added description of functions used by the frida script.
• Dump keybox from old versions of the CDM.

Changed

• Using a native function to intercept keybox (instead of libc).
• Execution of player/auto options before DRM detection (improves detection on older devices).
• Display of different keybox contents for the same device id.
• Simplifying function detection in JS.

Fixed

• Bad start of the widevine service when launching the script.
• Unsupported error of new ADB class.
• Detection of the MAIN activity for applications.
• Parsing error to list applications.
• Detection of the minimum number of functions required.

2.1.1 - 2024-10-28

Added

• Private key functionality for enhanced key extraction security.
• Local DRM server for (almost) offline use.
• Option to import the private key for easier management.
• Automatic installation and usage of a local player.
• New Advanced group for better argument organization.
• Experimental keybox extraction from the device.
• Added CDM details for SDK 35.

Changed

• Device interactions migrated to the ADB class for better encapsulation.
• Code comments added and optimizations made for clarity.
• Displaying the GetDeviceId function name.

Fixed

• Improved error handling for shell commands.
• xmltodict is now a required dependency.
• Enhanced formatting of logging messages for better readability.
• Error in skip option for using a function file.

2.1.0 - 2024-10-20

Added

• Added private key function.
• Option to skip automatic detection of private functions.
• Confirmed support for Widevine SDK 22.

Changed

• Updated dependencies.
• Clarified details regarding optional dependencies.

Fixed

• Extra argument in the GetDeviceID function.
• Incorrect handling of the display of unknown functions.

2.0.9 - 2024-09-25

Added

• Added private key function.

Changed

• Improved error handling related to file path issues during write operations.

2.0.8 - 2024-07-27

Added

• Added compatibility with WSA (Windows Subsystem for Android).

Changed

• Display location of liboemcrypto.so if detected (instead of the base address of the library).
• Simplified text for disabling the library.

New Contributors

• sn-o-w

2.0.7 - 2024-07-23

Changed

• Improved library disabler display.
• Optimized data export.
• Removed unnecessary cast.

Fixed

• Corrected disabled library address.
• Fixed multiple hooks in library disabler.
• Enhanced process enumeration for older Android versions.

New Contributors

• JohnDoe1964
• Nineteen93

2.0.6 - 2024-07-12

Changed

• Renamed the private key function.
• Updated the device ID function.
• Improved the deactivation message for a library.

Fixed

• Prevented multiple function replacements during a single execution.

2.0.5 - 2024-07-08

Added

• Added new private functions.
• Support for encrypted challenges in error messages.
• Dynamic disabling of liboemcrypto.so without using Magisk module.

Changed

• Organized imports.
• Updated some messages.
• New verbosity level for CDM to prevent confusion.

Fixed

• Detection of Widevine process.

2.0.4 - 2024-07-07

Fixed

• Vendor now in list to maintain the order of items (python set issue).

2.0.3 - 2024-07-07

Added

• Added support for private key function (SDK 35 x86_64).

Changed

• Removed confusing Malformed message warning.

2.0.2 - 2024-07-07

Added

• Vendor filtering based on device SDK.
• Improved device ID retrieval from challenges.

Changed

• Clarified library arguments in documentation.
• Improve library vendor detection.

Fixed

• Corrected Frida script encoding.
• Adjusted library arguments in documentation for clarity.
• Refined usage of function reference files.
• Updated support for OEM 18+ devices.

2.0.1 - 2024-07-06

Added

• Added support for handling Frida server running errors.

Changed

• Enhanced the relevance of pywidevine device (WVD) help documentation.

Fixed

• Corrected the size of the private key.

2.0.0 - 2024-07-06

Added

• Support for custom library names.
• Patch for the GetCdmClientPropertySet function to enforce unencrypted challenges on specific devices.
• Hook for the getOemcryptoDeviceId function for compatible devices.
• Native C API filter to prevent crashes during hooks.
• Handling of a binary challenge file to aid in resolving client IDs.
• Optional verbosity with output files if specified.
• Process watcher for library resolution, primarily for older devices.

Changed

• Removed display of OEM and library version as they were often incorrect.
• New patch method (rewriting) to enforce unencrypted challenges.
• Widevine detection method now based on process names.
• Program no longer stops when the function file is not used when normally required.
• Full path display of the library (instead of parent only).
• Program is now formatted as a library.
• Simplified symbol address resolution.
• New, more relevant output structure.
• Private key size is no longer recalculated.

Fixed

• Dynamic detection of the argument position for challenges.
• Corrected path for extracted files.
• Backward-compatible support for listing all processes via ADB.
• Fixed automatic mode device usage.
• Support for parsing errors related to CDM data.
• Frida session closure after process analysis.

1.1.0 - 2024-06-22

Added

• Implemented a system to filter potentially crash-inducing native C function names.

Changed

• Support for custom library names for new versions.

Fixed

• Corrected directory structure creation for devices.

New Contributors

• azimabid00

1.0.9 - 2024-06-02

Added

• Added autostart error message.
• Added private key function (30/arm64-v8a).
• Added private key function (34/arm64-v8a)

Changed

• Changed .wvd filename to original filename.
• Updated liboemcrypto-disabler link in docs.

Fixed

• Changed default index for vendor 34.

1.0.8 - 2024-05-22

Added

• Auto mode for opening the Bitmovin DRM player.
• Additional generation of the .wvd device.
• Added a function known from SDK 30 (arm64-v8a).

Changed

• Renamed JS script.
• Updated dependency versions.
• Use pywidevine for the protobuf part.

Fixed

• Support for int device names.
• Fixed dynamic auto mode.

New Contributors

• FoxRefire

1.0.7 - 2024-05-12

Added

• Added a new function specific to VENDOR 15 based on insights from videohelp.
• Included a detailed process for extracting keys in offline mode.

1.0.6 - 2024-04-26

Added

• Added mksrc script to manually improve Android shell interaction.

Changed

• Removed example from the XML functions to prevent misunderstandings.
• Enhanced the Android shell functionality.

Fixed

• Fixed encoding issues with ADB commands, addressing issue #3.

1.0.5 - 2024-04-08

Added

• Added a function known from SDK 33 (arm64-v8a).

Fixed

• Removed import analysis that was causing the JavaScript script to crash.

1.0.4 - 2024-04-06

Added

• Added the --force option to use the default vendor, bypassing analysis.
• Progress information for analysis stages.
• Support for Android 14.
• Error message for using SDK version 34 and above without an XML functions file.
• Documentation links for certain error messages.

Changed

• Switched from Frida to ADB for listing processes due to a Frida issue.
• Optimized process search to improve performance.
• Improved error reporting when the Widevine process is not detected.

Fixed

• Fixed compatibility with buggy frida-server versions by using direct PID attachment.
• Updated the script handling for non-standard version scenarios.

1.0.3 - 2024-04-01

Added

• Environment check for ADB and automatic start if not running.
• Extraction function support for SDK version 34 and above.
• Simplified command-line argument processing.

Changed

• Enhanced error handling to avoid Frida library hook errors.
• Transitioned from using symbols to functions for better clarity and efficiency.
• Display of loaded script for improved debugging and verification.

Fixed

• Resolved target analysis issues, ensuring accurate process targeting.
• Corrected function argument count errors for more robust script execution.
• Fixed function selection by name to accurately identify and use the correct functions.

1.0.2 - 2024-03-31

Added

• Added support for interpreting and using symbols, enhancing analysis capabilities.

Changed

• Optimized analysis logic during the hook process for increased efficiency.
• Improved script generation process for more reliable and effective hooking.

1.0.1 - 2024-03-31

Added

• Introduced support for non-standard version handling, accommodating a wider range of target applications.

1.0.0 - 2024-03-30

Added

• Initial release of the project, laying the foundation for future enhancements and features.