Video encryption while maintaining playability.
Project description
Sanzan
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
Decrypted Video:
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 forcv2.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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.