thaloco/aman
1
Fork 0
Code Pull requests Releases Packages Activity Actions
aman/README.md

2.3 KiB
Raw Blame History

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:

uv sync

Run:

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

Open settings:

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

Config

Create ~/.config/lel/config.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. Use the settings window to list available input devices.

systemd user service

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:

make run