glo/desktop
2026-10-14 05:05:05 +00:00
..
2026-10-14 04:55:41 +00:00
2026-10-14 05:05:05 +00:00

# angelhome

desktop app for angelhome

`main.py` opens site in a locked qtwebengine browser instead of normal browser.

## compatible with

- linux
- pyside6
- qtwebengine

### does

- allows only the approved https host
- blocks external navigation
- blocks popups
- blocks downloads
- denies browser permission requests
- rejects bad tls/certificate errors
- keeps a single app instance
- stores login/session data beside the app, keeps between restarts
- logs startup/runtime errors

### requirements

install python packages:

```bash
pip install PySide6

run with python

python3 main.py

or:

python main.py

log output

angelhome_data/logs/angelhome.out.log

persistent data

local app data is stored beside the script or bundled binary:

angelhome_data/
  logs/
  runtime/
  cache/
  storage/

this is used for:

  • session persistence
  • cache
  • logs
  • runtime lock file