yashdev9274 / yashdev9274/supercli

[Bug] Voice capture UI freeze & Linux compatibility issues (ffmpeg process & Bun.file dependency)

Open
#234 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
TypeScript
Stars
214
Forks
41
Avg merge
2h 26m
Merged PRs (30d)
34

Description

Description

When using the voice capture feature (Ctrl + V), two main issues occur:

  1. UI Refresh Bug: After speaking, the transcribed text is added to stdinInput, but renderInput() is not called and activeFooter status is not cleared. This leaves the "Recording..." popup visible and hides the transcribed text until extra keypresses force a UI re-render.
  2. Linux/Node Process Management: On Linux/Node runtime, ffmpeg doesn't exit cleanly with SIGKILL/SIGTERM during voice capture, leading to empty/corrupted audio files or hanging processes. Switching to SIGINT allows ffmpeg to finalize the WAV header properly.
Steps to Reproduce
  1. Press Ctrl + V to start recording.
  2. Speak a phrase and press Ctrl + V (or Enter) to stop.
  3. Observe that the footer status message remains stuck on "Recording..." and the text does not appear in the input prompt immediately.
Suggested Fixes / Code Context

In startVoiceCapture() / input event handler:

  • UI Reset & Render: Ensure activeFooter.setStatusMessage("") is called in the finally block or on success, followed by renderInput() after setting stdinInput so the transcribed text is displayed right away.
  • Process Termination: Send SIGINT instead of SIGTERM/SIGKILL to the ffmpeg spawned process so it cleanly stops recording and flushes the WAV file headers before transcription.
  • Platform Agnostic Audio: Fallback gracefully when avfoundation or Bun.file are not available in non-macOS or non-Bun environments.
Environment
  • OS: Linux (CachyOS / Arch)
  • Audio Subsystem: PipeWire / PulseAudio

Opened on behalf of @YounessTaki0.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with startVoiceCapture() and the input event handler, then reproduce the Ctrl + V flow on Linux to observe the footer and input rendering. Check the spawned ffmpeg process termination and the availability of avfoundation and Bun.file. Done means the recording status clears, transcribed text appears immediately, ffmpeg finalizes the WAV reliably, and unsupported environments fail gracefully.

Written by the indexing model from the issue text.

Assessment

Tech stack
bun, linux, typescript
Domain
cli, operating-systems
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.