glo/desktop/README.md
2026-10-14 05:07:40 +00:00

64 lines
902 B
Markdown

##### angelhome
desktop app for angelhome
`main.py` opens site in a locked qtwebengine browser instead of normal browser.
- desktop wrapper
- allows only approved https
- 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
```bash
python3 main.py
```
or:
```bash
python main.py
```
#### log output
```text
angelhome_data/logs/angelhome.out.log
```
#### persistent data
local app data is stored beside the script or bundled binary:
```text
angelhome_data/
logs/
runtime/
cache/
storage/
```
this is used for:
- session persistence
- cache
- logs
- runtime lock file
```