yashdev9274 / yashdev9274/supercli
[Bug] Voice capture UI freeze & Linux compatibility issues (ffmpeg process & Bun.file dependency)
Open
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:
- UI Refresh Bug: After speaking, the transcribed text is added to
stdinInput, butrenderInput()is not called andactiveFooterstatus is not cleared. This leaves the "Recording..." popup visible and hides the transcribed text until extra keypresses force a UI re-render. - Linux/Node Process Management: On Linux/Node runtime,
ffmpegdoesn't exit cleanly withSIGKILL/SIGTERMduring voice capture, leading to empty/corrupted audio files or hanging processes. Switching toSIGINTallowsffmpegto finalize the WAV header properly.
Steps to Reproduce
- Press
Ctrl + Vto start recording. - Speak a phrase and press
Ctrl + V(or Enter) to stop. - 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 thefinallyblock or on success, followed byrenderInput()after settingstdinInputso the transcribed text is displayed right away. - Process Termination: Send
SIGINTinstead ofSIGTERM/SIGKILLto theffmpegspawned process so it cleanly stops recording and flushes the WAV file headers before transcription. - Platform Agnostic Audio: Fallback gracefully when
avfoundationorBun.fileare 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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