Question 1

How do I encrypt a large file in .NET without running out of memory?

Accepted Answer

StreamCryptor processes files in chunks using FileStream, so it never loads the entire file into memory. Use the EncryptFileWithStream method with configurable chunk sizes (default ~1MB), as shown in the synchronous and async examples in the README.

Question 2

StreamCryptor vs AES for file encryption: which is better?

Accepted Answer

StreamCryptor uses libsodium's XSalsa20/Poly1305 for authenticated encryption, which is modern and secure, and handles large files efficiently via streaming. AES is more standard and interoperable, but StreamCryptor adds integrity checks and low memory overhead, though with a custom file format.

Question 3

Can I use StreamCryptor with .NET Core or .NET 6?

Accepted Answer

The library targets .NET Framework 4.5, so compatibility with .NET Core isn't guaranteed out of the box. You may need to check for updates or use compatibility layers, as it relies on libsodium-net which might have .NET Standard versions.

Question 4

How to show a progress bar when encrypting files with StreamCryptor?

Accepted Answer

Use the async methods like EncryptFileWithStreamAsync that accept an IProgress<StreamCryptorTaskAsyncProgress> parameter. Implement progress reporting in your UI by handling the progress updates, as demonstrated in the provided async demo examples.

Question 5

What is SCCEF format and how can I decrypt it without StreamCryptor?

Accepted Answer

SCCEF is StreamCryptor's custom chunked encrypted file format with header, chunks, and footer sections. Decryption without the library is complex due to the proprietary structure and libsodium encryption; it's primarily designed for use with StreamCryptor, limiting third-party tool support.

Question 6

Is StreamCryptor good for encrypting database backups?

Accepted Answer

Yes, its streaming architecture makes it ideal for large files like database backups, providing security with low memory overhead. Just ensure you manage keys properly, especially if using ephemeral keys for privacy, which sacrifices sender authentication.

StreamCryptor

What is StreamCryptor?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions