---
slug: "qmxme-pi-lametric-notify"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/qmx/pi-lametric-notify@master/README.md"
repo: "https://github.com/qmx/pi-lametric-notify"
source_file: "README.md"
branch: "master"
---
# pi-lametric-notify

A pi package that sends a LaMetric Time notification when pi finishes a task and is waiting for input.

## What it shows

- success: icon `a8813` + `done`
- error: icon `a423` + `error`
- next frame: hostname
- next frame: current tmux pane via `#S:#I.#P`, if available

## Config

Set these environment variables before starting pi:

```bash
export LAMETRIC_TIME_HOST=192.168.1.100
export LAMETRIC_TIME_API_KEY=your-api-key

# Optional: enable sound (knock-knock for success, negative1 for error)
export LAMETRIC_TIME_SOUND=1
```

`LAMETRIC_TIME_HOST` can be either:
- a host or IP like `192.168.1.100`
- a full base URL like `http://192.168.1.100:8080`

If either variable is missing, the extension does nothing.
If LaMetric is unreachable, the IP is wrong, or the request fails, the extension stays silent, times out quickly, and does not block or crash pi.

## Install

From this repo:

```bash
pi install .
```

Once published:

```bash
pi install npm:@qmxme/pi-lametric-notify
```

Or load it directly for a single run:

```bash
pi -e .
```

## Notes

- notifications are sent to the local LaMetric notifications API
- the message repeats for 3 cycles
- tmux info is only shown when pi is running inside tmux
- the extension sends notifications on `agent_end`