page-encryptor 0.1.0

Offline HTML encryption with in-browser decryption, inspired by PageCrypt

🔐 page-encryptor

page-encryptor is a simple Python utility to encrypt static HTML pages offline and embed a JavaScript-based decryptor for in-browser access. It's inspired by PageCrypt by Max Laumeister, but is independently developed and substantially refactored for modern Python workflows and packaging.

✨ Features

• AES-GCM encryption with PBKDF2 key derivation
• Fully static: No server required
• Runs offline — ideal for sensitive or private HTML content
• Decrypts in-browser using an embeddable JavaScript template
• Designed for automation and integration into static site generators (e.g., 11ty)
• Lightweight and dependency-minimal

📦 Installation

pip install page-encryptor

🚀 Usage

page-encryptor \
  --input path/to/file.html \
  --password your-secret-password \
  --template decryptor_template.html \
  --output protected-file.html

The template file must contain the placeholder __PAYLOAD__ which will be replaced with the encrypted data payload. See decryptor_template.html.

🧩 Example

page-encryptor \
  --input index.html \
  --template decryptor_template.html \
  --output index-protected.html \
  --password hunter2

You can now open index-protected.html in a browser and enter your password to decrypt it in place.

📁 Template Format

The decryptor_template.html should contain the following placeholder:

/*{{ENCRYPTED_PAYLOAD}}*/""

This will be replaced with the actual encrypted payload in Base64.

🧠 Credits & Inspiration

This project is inspired by the excellent PageCrypt by Max Laumeister

🛠️ Development

To set up the project locally:

git clone https://github.com/yourname/page-encryptor.git
cd page-encryptor
python3 -m venv venv
source venv/bin/activate.fish
pip install -r requirements.txt

Run formatting and hooks:

pre-commit install
pre-commit run --all-files