Metadata-Version: 2.4
Name: aranet4-tui
Version: 0.1.0
Summary: Log Aranet4 CO₂/temperature/humidity readings to SQLite, with a Textual TUI.
Project-URL: Homepage, https://github.com/northisup/aranet4-tui
Project-URL: Issues, https://github.com/northisup/aranet4-tui/issues
Author-email: Adam Hitchcock <adam@askclara.com>
License: MIT
Keywords: aranet4,co2,sqlite,textual,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Home Automation
Classifier: Topic :: Terminals
Requires-Python: >=3.13
Requires-Dist: aranet4>=2.6.0
Requires-Dist: textual>=8.2.3
Description-Content-Type: text/markdown

# aranet4-tui

Log [Aranet4](https://aranet.com/products/aranet4/) CO₂ / temperature / humidity / pressure
readings to a local SQLite file, and browse them in a Textual TUI.

## Install

```sh
# one-shot via uvx (no install)
uvx --from aranet4-tui aranet-log --scan
uvx --from aranet4-tui aranet4-tui

# persistent install
uv tool install aranet4-tui
# or
pipx install aranet4-tui
```

## Use

```sh
aranet-log --scan                       # find your device's address
aranet-log <ADDRESS> --once             # sync history once
aranet-log <ADDRESS>                    # sync forever (every 5 min)
aranet4-tui                             # open the TUI
```

The DB lives at `~/Library/Application Support/aranet-log/readings.db` on macOS, or
`$XDG_DATA_HOME/aranet-log/readings.db` (default `~/.local/share/...`) on Linux.
Override with `--db PATH` or `$ARANET_LOG_DB`.

## macOS launchd

Install a launchd agent that runs `aranet-log --once` every 5 minutes:

```sh
aranet-log <ADDRESS> --install-launchctl
# logs: ~/Library/Logs/aranet-log.log
aranet-log --uninstall-launchctl
```
