WINDOWS_INTEGRATION.md

# Windows Integration

HVCE v4 includes a direct CLI, a Tkinter GUI, and current-user shell integration scripts.

## CLI

```cmd
python hvce.py test
python hvce.py compress C:\Data C:\Data.hvce --profile balanced --recovery-percent 10
python hvce.py extract C:\Data.hvce C:\Restored --overwrite
```

## GUI

```cmd
python hvce_gui.py
```

The GUI supports:

- compress folder/file;
- optional password;
- optional 10% recovery record;
- extract;
- inspect;
- repair.

## Context menu install

From the package directory:

```powershell
powershell -ExecutionPolicy Bypass -File windows\install_context_menu.ps1
```

This adds current-user entries for:

- right-click folder/file -> **Compress with HVCE**;
- right-click `.hvce` archive -> **Extract HVCE here**;
- right-click `.hvce` archive -> **Open HVCE GUI**.

Uninstall:

```powershell
powershell -ExecutionPolicy Bypass -File windows\uninstall_context_menu.ps1
```

The `.reg` file is a template for manual users who prefer registry import.