Files

T

m3ta-chiron e7765ee39f feat(talk): read API key from agenix file instead of env var

Primary: /run/agenix/elevenlabs-key (read via 'read -r' which strips
the trailing newline agenix files contain).
Fallback: ELEVENLABS_API_KEY env var (backwards compatible).

No need to export the key in shell environment anymore — if the
agenix secret exists, talk picks it up automatically.

Override path via ELEVENLABS_KEY_FILE env var if needed.

2026-07-02 20:14:45 +02:00

2.9 KiB

Raw Blame History

talk

ElevenLabs TTS voice notifications with a dismissable desktop popup. Generates speech from text via the ElevenLabs API, plays it through mpv, and shows a notification with a ⛔ Abbrechen button to stop playback.

Usage

Argument

talk "Build abgeschlossen. Alle Tests erfolgreich."

Stdin (pipe)

echo "Deployment fertig" | talk
nixos-rebuild build 2>&1 | tail -3 | talk
pi -p "Fasse zusammen" | talk

Environment Variables

Variable	Required	Default	Description
`ELEVENLABS_API_KEY`	⚠️	—	Fallback if agenix file is absent
`ELEVENLABS_KEY_FILE`	❌	`/run/agenix/elevenlabs-key`	Path to agenix secrets file (preferred)
`ELEVENLABS_VOICE_ID`	❌	`KXxZd16DiBqt82nbarJx`	Voice ID to use
`VOICE_NOTIFY`	❌	`1`	Set to `0` to silence all output

The API key is read from the agenix file at /run/agenix/elevenlabs-key by default. The file should contain just the key (trailing newline is stripped automatically via read -r). If the file doesn't exist, talk falls back to the ELEVENLABS_API_KEY environment variable.

How It Works

Sends text to ElevenLabs text-to-speech API → receives MP3
Plays audio via mpv (background)
Shows notify-send popup with ⛔ Abbrechen action (background)
Polls every 0.2s:
- If mpv finished → kill notification, exit
- If user clicked Abbrechen → kill mpv, exit
Cleans up temp files on exit

Cancel Button

The notification popup has a ⛔ Abbrechen action button. Clicking it kills mpv playback immediately. The popup disappears when audio finishes or is cancelled.

The poll loop uses [ -s ] (non-empty file check) on the action output file. This ensures the loop only reacts when notify-send actually writes the action key — not when the empty file is created by the shell redirect.

Integration Patterns

After long-running tasks

nixos-rebuild switch 2>&1 | tail -5 | talk

With AI agents (print mode)

# Pi
pi -p "Review diesen Code" | talk

# OpenCode
opencode run "Erkläre diese Funktion" -q | talk

With crunch (scheduled jobs)

crunch ai pi daily "08:00" "Fasse Basecamp Todos zusammen"
# → talk speaks the summary at 08:00

NixOS Installation

# home-manager
home.packages = [ pkgs.m3ta.talk ];

The API key is read from /run/agenix/elevenlabs-key at runtime — set up the secret in your agenix configuration:

# secrets.nix
age.secrets."elevenlabs-key" = {
  file = ./secrets/elevenlabs-key.age;
  # Optionally set owner/group if needed
};

No need to export ELEVENLABS_API_KEY in shell environment anymore.

Dependencies

curl — API calls
python3 — JSON payload construction
mpv — audio playback
libnotify — desktop notification
busybox — coreutils (rm, cat, grep, sleep, kill, stat)

2.9 KiB Raw Blame History