# lel

Python X11 transcription daemon that records audio, runs Whisper, logs the transcript, and can optionally run AI post-processing before injecting text.

## Requirements

- X11 (not Wayland)
- `sounddevice` (PortAudio)
- `soundfile` (libsndfile)
- `faster-whisper`
- Tray icon deps: `gtk3`
- Python deps: `pillow`, `python-xlib`, `faster-whisper`, `PyGObject`, `i3ipc`, `sounddevice`, `soundfile`

System packages (example names): `portaudio`/`libportaudio2` and `libsndfile`.

## Python Daemon

Install Python deps:

```bash
uv sync
```

Run:

```bash
uv run python3 src/leld.py --config ~/.config/lel/config.json
```

## Config

Create `~/.config/lel/config.json`:

```json
{
  "daemon": { "hotkey": "Cmd+m" },
  "recording": { "input": "0" },
  "transcribing": { "model": "base", "device": "cpu" },
  "injection": { "backend": "clipboard" },

  "ai_cleanup": {
    "enabled": true,
    "model": "llama3.2:3b",
    "temperature": 0.0,
    "base_url": "http://localhost:11434",
    "api_key": ""
  }
}
```

Env overrides:

- `WHISPER_MODEL`, `WHISPER_DEVICE`
- `WHISPER_FFMPEG_IN` (device index or name)
- `LEL_HOTKEY`, `LEL_INJECTION_BACKEND`
- `LEL_AI_CLEANUP_ENABLED`, `LEL_AI_CLEANUP_MODEL`, `LEL_AI_CLEANUP_TEMPERATURE`
- `LEL_AI_CLEANUP_BASE_URL`, `LEL_AI_CLEANUP_API_KEY`

Recording input can be a device index (preferred) or a substring of the device
name.

## systemd user service

```bash
mkdir -p ~/.local/bin
cp src/leld.py ~/.local/bin/leld.py
cp systemd/lel.service ~/.config/systemd/user/lel.service
systemctl --user daemon-reload
systemctl --user enable --now lel
```

## Usage

- Press the hotkey once to start recording.
- Press it again to stop and transcribe.
- The transcript is logged to stderr.

Injection backends:

- `clipboard`: copy to clipboard and inject via Ctrl+Shift+V (GTK clipboard + XTest)
- `injection`: type the text with simulated keypresses (XTest)

AI provider:

- Generic OpenAI-compatible chat API at `ai_base_url` (base URL only; the app uses `/v1/chat/completions`)

Context capture (i3 only):

- The focused window at hotkey time is stored via i3 IPC.
- If focus changes before injection, the workflow aborts (interpreted as a cancel).

Control:

```bash
make run
```