hark-viewer
A live transcript page and recording controls for hark, the macOS CLI that captures system audio and the microphone and transcribes them on-device.
hark-viewer shows the transcript in the browser while hark writes it, with a colour per speaker and a clock time per line, and puts Record, Stop, Pause and Mute on the same page. It also ships an agent skill, so a coding agent such as Claude Code can start a recording and answer questions about the call while it is happening.
Features
- Records the whole computer plus your microphone through hark's Core Audio tap, with no virtual audio driver.
- Keeps your microphone on the left channel and the call on the right.
- Labels lines
You for the microphone and Speaker 1..N for voices on the computer side.
- Shows the line still being spoken in grey, when hark can stream it.
- Starts, stops, pauses and mutes from the page. No terminal window stays open.
- Warns when the capture dies, and restarts it into the same call folder.
- Files every call in its own folder, keeps the audio, and writes an accurate transcript once the call stops (its call side needs a hark newer than 0.4.3).
- Says which languages a call was in, and fixes live speaker labels after the call with
relabel.
- Runs on
127.0.0.1 only. Nothing leaves the machine.
Quick start
git clone https://github.com/GeiserX/hark-viewer.git
cd hark-viewer
./hark-viewer work "Weekly sync" # record a call filed under "work" and open the page
Needs macOS 14.4 or later on Apple Silicon, hark 0.4.3 or later with the Parakeet model, and the Python 3 macOS ships. Setup is in Getting started.
Documentation
The full documentation is at geiserx.github.io/hark-viewer.
- Getting started: requirements, the hark models, first recording
- Configuration: every setting and its default
- Usage: every command, URL options, where calls are filed
- How it works: the server, its API, what it asks hark to record
- Troubleshooting: when the capture dies mid-call, the warnings, Restart, and how to report a bug
- Development: running the tests
- The accurate transcript: the offline pass after a call, and language detection
- As an agent skill: Claude Code, fixing speakers, getting your own voice back out
- Limits: what it cannot do yet. Recording a call needs the consent of the people on it.
License
GPL-3.0-or-later
