clearweb-archive 0.1.0

Read and write ClearWeb archives for Clear Browser.

clearweb-archive

clearweb-archive is a Python library and command line tool for creating and reading ClearWeb archives. A ClearWeb archive is a password-protected package for portable static HTML sites that can link between pages and include local resources such as images, stylesheets, and scripts.

ClearWeb archives use the Space64 encrypted local archive container through the space64-local-archive Python package.

Install

pip install clearweb-archive

Write

from clearweb_archive import create_clearweb_archive

create_clearweb_archive(
    "site",
    "site.clearweb",
    password="correct horse battery staple",
    title="My Offline Site",
    root="index.html",
)

Read

from clearweb_archive import read_clearweb_archive

archive = read_clearweb_archive(
    "site.clearweb",
    password="correct horse battery staple",
)
root_bytes = archive.root_file.data

CLI

clearweb pack site site.clearweb --password "correct horse battery staple"
clearweb inspect site.clearweb --password "correct horse battery staple"

Security Notes

The password protects archive contents at rest. Applications that open archives may still need to extract or materialize files temporarily for WebView loading; those temporary files should be treated as sensitive data and cleaned up by the application.

ClearWeb is not an anonymity system, VPN, or network privacy tool. It is a local archive format for storing and transporting web content.