# twilio-recordings-decrypter

**Repository Path**: mirrors_twilio/twilio-recordings-decrypter

## Basic Information

- **Project Name**: twilio-recordings-decrypter
- **Description**: A sample app demonstrating how to decrypt Programmable Video recordings
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-22
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Twilio Media Decrypter

This program downloads and decrypts Recordings and Compositions encrypted using Twilio's Programmable Video capabilities. For further information check the [Official Twilio Documentation](https://www.twilio.com/docs/video/tutorials/encrypting-your-stored-media)

### PRE-REQUISITES

* Java 8.
* If you are using Oracle's JDK, you need have installed the [Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files](http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html)
in your system.

## Usage

The program requires the following arguments
* The encrypted `SourceSid`. When decrypting a Recording this must be a string of the form `RTxx`. When decrypting a Composition it takes the form `CJxx`. In both `xx` is a 32 bytes alphanumeric code.
* Your Twilio's API key and secret (`SKxx:API_SECRET`)
* The private key corresponding to the public key used by Twilio for encrypting the file. This key must be encoded according to the PKCS #8 standard. If you generated the key pair with `openssl`, you'll need to execute the following command
  ```
  openssl pkcs8 -in private_key.pem -topk8 -nocrypt -out private_key_pkcs8.pem
  ```
* The filename where the decrypted media will be stored. Remember to add the extension (`.mkv`, `.mka`, `.mp4`, `.webm`, etc.)

1. Compile the project
    ```
    mvn clean package
    ```
2. Execute the jar file with the appropriate arguments. For example, for a video track:
    ```
    java -jar target/twilio-media-decrypter.jar SKxx:API_SECRET SourceSid privatekey-pkcs8.pem decrypted-filename.mkv
    ```