Skip to main content

Password Protection

Work with password-protected ZIP archives using AES-256 encryption.

Extract a Protected Archive​

import { getUnzip } from 'react-native-nitro-unzip';

const unzip = getUnzip();
const task = unzip.extractWithPassword(
  '/path/to/encrypted.zip',
  '/path/to/output',
  'mypassword'
);

task.onProgress((p) => {
  console.log(`${(p.progress * 100).toFixed(0)}%`);
});

const result = await task.await();

extractWithPassword works identically to extract but takes a third password parameter. Progress tracking and cancellation work the same way.

Create a Protected Archive​

const task = unzip.zipWithPassword(
  '/path/to/folder',
  '/output/secure.zip',
  'mypassword'
);

const result = await task.await();

Encryption Details​

PlatformEncryption (write)Encryption (read)
AndroidAES-256 via zip4jAES-256 + traditional PKWARE (zip4j)
iOS (0.5.0+)AES-256 via SSZipArchive's aes: true overloadAES-256 + traditional PKWARE (SSZipArchive)
0.5.0 — iOS now writes AES-256

0.3.x used SSZipArchive's withPassword: overload on iOS, which writes traditional PKWARE encryption — broken and crackable in minutes with modern tools. 0.5.0 switches to the aes: true overload, matching Android's AES-256 strength. Cross-platform password archives now have equivalent crypto strength.

Cross-platform compatibility

Archives created with zipWithPassword on one platform can be extracted with extractWithPassword on the other.