Skip to main content

Video encryption while maintaining playability.

Project description

Sanzan

PyPI Release tests PyPI Version

Sanzan is a simple encryption library to encrypt and decrypt videos while maintaining playability.

It uses NumPy and OpenCV to perform video frame manipulation, while using FFmpeg and Pydub for audio manipulation. Sanzan can be used either from the command line or in a Python program.

Encrypted Video

Encrypted

Decrypted Video:

Decrypted

Installation

Prerequisite

FFmpeg must be installed and in PATH.

pip install sanzan

Usage

Encryption

sz -e original.mp4 -o encrypted.mp4 -pw <password>

On a stream

sz -e https://youtu.be/dQw4w9WgXcQ -o encrypted.mp4 -pw <password>

Decryption

With preview

sz -d encrypted.mp4 -o decrypted.mp4 -pw <password> -p

With keyfiles

Use the -kv and -ka flags to specify keyfiles when decrypting.

sz -d encrypted.mp4 -o decrypted.mp4 -kv key.szvk -ka key.szak

More Usage

Omit the -pw flag to encrypt using randomly generated keyfiles.

sz -e original.mp4 -o encrypted.mp4

Use the -s flag to hide progress bars. This might slightly improve performance.

Use the -c flag to specify the audio chunksize. The default is 100.

Use the -ex flag to export the keyfiles generated using a password.

Python Usage

Alternatively, Sanzan provides a Python interface to programmatically access its functionality.

Encryption

from sanzan import Encryptor

PW = "p@ssw0rd"

if __name__ == "__main__":
    e = Encryptor("original.mp4")
    e.gen_key(password=PW)
    e.gen_audio_key(password=PW)
    e.set_output("encrypted.mp4")
    e.run()

Decryption

from sanzan import Decryptor

PW = "p@ssw0rd"

if __name__ == "__main__":
    d = Decryptor("encrypted.mp4")
    d.set_key(password=PW)
    d.set_audio_key(password=PW)
    d.set_output("decrypted.mp4")
    d.run(preview=True)

Note

  • Audio is not supported for streams.
  • Previewing audio is not supported.
  • Because cv2.waitKey is unable to maintain a consistent playback framerate for cv2.imshow, preview mode will display frames as quickly as they are generated.
  • Container formats like MKV will not decrypt reliably and must be converted to mp4 before encrypting. See this issue.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Sanzan-1.0.0.tar.gz (6.2 kB view hashes)

Uploaded source

Built Distribution

Sanzan-1.0.0-py3-none-any.whl (6.7 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page