Speakr is a personal, self-hosted web application designed for transcribing audio recordings
Python
Explain the Chrome-on-Linux monitor-source filter so users know why the picker doesn't show 'Monitor of …' entries — Chrome deliberately hides PulseAudio monitor sources from navigator.mediaDevices.enumerateDevices for privacy reasons, even though pavucontrol exposes them fully at the OS level; the picker can only list what Chrome enumerates so without context this looks like a Speakr bug; (a) Linux help-modal section restructured — three options now: A tab audio (no setup, no pavucontrol), B mid-recording pavucontrol source swap (mic-or-monitor not both), C recommended virtual-source wrap via 'pactl load-module module-virtual-source source_name=speakr_loopback master=<sink>.monitor' which exposes a Pulse monitor as a regular source Chrome WILL list, with reboot-persistence note pointing at default.pa; PipeWire equivalent (pw-loopback) added; (b) inline picker hint that shows ONLY on Linux: amber info-circle with one-line explanation and an 'Open guide' link that jumps straight to the help modal, so users see the workaround at the moment of confusion without having to know to look elsewhere
Murtaza Nasir717e10e277fa
diff --git a/templates/components/upload-view.html b/templates/components/upload-view.htmlindex c31a4d70..bcdebab6 100644--- a/templates/components/upload-view.html+++ b/templates/components/upload-view.html@@ -333,7 +333,22 @@</option></select><p class="text-[10px] mt-1" style="color: var(--text-muted);">- Pick a monitor source ("Monitor of …" on Linux, BlackHole on macOS, VB-Cable on Windows) to mix system audio with your mic. Both streams combine into one recording.+ Pick a monitor / virtual audio device (BlackHole on macOS, VB-Cable on Windows, or a wrapped Pulse monitor on Linux) to mix system audio with your mic. Both streams combine into one recording.+ </p>+ <!-- Linux-specific: Chrome filters+ "Monitor of ..." sources out of+ enumerateDevices, so the picker+ above won't show them by default+ even though pavucontrol does.+ Point users at the help guide+ where Option C explains the+ pactl one-liner to expose a+ virtual source Chrome WILL list. -->+ <p v-if="platformInfo && platformInfo.os === 'Linux'"+ class="text-[10px] mt-1" style="color: var(--text-muted);">+ <i class="fas fa-circle-info text-amber-500"></i>+ Don't see "Monitor of …" entries? Chrome on Linux filters them out. The help guide's Linux → Option C shows a one-line <code style="background: var(--bg-secondary); padding: 0 2px; border-radius: 2px;">pactl</code> command to expose a Pulse monitor as a regular source Chrome will list.+ <button @click.prevent="showSystemAudioHelp = true" class="underline" style="color: var(--text-accent);">Open guide</button></p></div></template>diff --git a/templates/modals/system-audio-help-modal.html b/templates/modals/system-audio-help-modal.htmlindex e862df4e..7f3cb8e3 100644--- a/templates/modals/system-audio-help-modal.html+++ b/templates/modals/system-audio-help-modal.html@@ -127,26 +127,44 @@</div><div>- <div class="t-body-strong" style="margin-bottom: var(--sp-1);">Option B — Full system audio via PulseAudio monitor (one-time setup)</div>+ <div class="t-body-strong" style="margin-bottom: var(--sp-1);">Option B — Switch source in pavucontrol mid-recording</div><p class="t-body" style="color: var(--text-secondary);">- Every Linux audio sink has a corresponding "monitor" source you can record FROM. Chrome can pick it as a microphone input — then anything playing through your speakers gets captured. Use the <strong>Microphone</strong> button, not System Audio.+ Quick but limited: captures system audio AT THE COST OF your mic input — useful only when you want to record what's playing through your headphones / speakers without your own voice.</p><ol class="list-decimal list-inside space-y-1 t-body" style="color: var(--text-secondary); margin-top: var(--sp-2);">- <li>Open <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">pavucontrol</code></li>- <li>In <strong>Configuration</strong> tab, make sure your output device profile is set (HDMI / Analog Stereo / etc.)</li>- <li>In Speakr, click <strong>Microphone</strong> and grant permission. This makes Chrome enumerate input devices including monitor sources.</li>- <li>While Speakr is recording, open pavucontrol's <strong>Recording</strong> tab. Find Speakr's capture entry and switch its source from your microphone to <strong>Monitor of <your output></strong></li>- <li>Subsequent records will remember this routing if you make it the default.</li>+ <li>Click <strong>Microphone</strong> in Speakr</li>+ <li>Open <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">pavucontrol</code> → <strong>Recording</strong> tab</li>+ <li>Change Speakr's capture source from your mic to <strong>Monitor of <your output></strong></li></ol>- <p class="t-meta" style="margin-top: var(--sp-2);">- To capture BOTH your mic and the monitor, create a virtual combined source: <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">pactl load-module module-null-sink sink_name=combined</code> then loopback both inputs to it.+ </div>++ <div>+ <div class="t-body-strong" style="margin-bottom: var(--sp-1);">Option C — Expose a virtual source so Chrome will list it (recommended)</div>+ <p class="t-body" style="color: var(--text-secondary);">+ <strong>Why this is needed:</strong> Chrome on Linux deliberately filters "Monitor of …" sources out of the input device list it exposes to web apps — that's why Speakr's input-device picker doesn't show them even though pavucontrol does. The fix is to wrap a monitor source in a regular virtual source that Chrome doesn't filter. Once you do this, the new source appears in Speakr's picker and you can use it as either the primary input OR as a "Also mix in" alongside your real mic to capture BOTH your voice and system audio in one stream.+ </p>+ <div class="banner banner--info" style="display: flex; align-items: flex-start; gap: var(--sp-2); margin: var(--sp-2) 0;">+ <i class="fas fa-circle-info" style="margin-top: 2px;"></i>+ <div class="t-meta" style="flex: 1; min-width: 0;">+ <div class="t-body-strong" style="margin-bottom: var(--sp-1);">Quick setup (one-time)</div>+ <p>Find your output sink name (the part before <code style="background: var(--bg-secondary); padding: 1px 4px; border-radius: 3px;">.monitor</code>):</p>+ <pre style="background: var(--bg-secondary); padding: var(--sp-2); border-radius: 4px; margin-top: var(--sp-1); overflow-x: auto; font-size: 11px;">pactl list short sinks</pre>+ <p style="margin-top: var(--sp-2);">Then wrap its monitor as a virtual source Chrome will list:</p>+ <pre style="background: var(--bg-secondary); padding: var(--sp-2); border-radius: 4px; margin-top: var(--sp-1); overflow-x: auto; font-size: 11px;">pactl load-module module-virtual-source \+ source_name=speakr_loopback \+ master=<sink_name>.monitor</pre>+ <p style="margin-top: var(--sp-2);">Reload Speakr's input-device picker — you'll now see <strong>speakr_loopback</strong> in the dropdown. Pick it as <strong>"Also mix in"</strong> alongside your real mic and you'll capture both.</p>+ </div>+ </div>+ <p class="t-meta">+ To persist across reboots, add the <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">load-module module-virtual-source source_name=speakr_loopback master=<sink_name>.monitor</code> line to <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">~/.config/pulse/default.pa</code>.</p></div><div><div class="t-body-strong" style="margin-bottom: var(--sp-1);">PipeWire (newer distros)</div><p class="t-body" style="color: var(--text-secondary);">- Same monitor-source pattern. Use <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">qpwgraph</code> or <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">helvum</code> to wire your playback sink's monitor into Chrome's capture input.+ Same idea — wrap the monitor in a virtual source so Chrome doesn't filter it. Use <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">pw-loopback</code>: <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">pw-loopback --capture-props='node.target=<sink>.monitor' --playback-props='media.class=Audio/Source node.name=speakr_loopback'</code>. Or use <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">qpwgraph</code> / <code style="background: var(--bg-tertiary); padding: 1px 4px; border-radius: 3px;">helvum</code> to wire it visually.</p></div></div>