Skip to content

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

feat(config): experimental_meeting_piggyback flag (default off) plumbed config->cli->engine->audio options

Ezra Ellette9ca42941e36c
diff --git a/crates/screenpipe-audio/src/audio_manager/builder.rs b/crates/screenpipe-audio/src/audio_manager/builder.rs
index a8e3297c5..ffa0b2fc7 100644
--- a/crates/screenpipe-audio/src/audio_manager/builder.rs
+++ b/crates/screenpipe-audio/src/audio_manager/builder.rs
@@ -119,6 +119,10 @@ pub struct AudioManagerOptions {
/// When false (default), System Audio uses ScreenCaptureKit as before.
/// Has no effect on non-macOS or macOS <14.4 — falls back to SCK.
pub experimental_coreaudio_system_audio: bool,
+ /// Experimental: meeting-driven per-process capture (piggyback). Read by
+ /// the device monitor's piggyback sweep; no effect anywhere else. Default
+ /// false — see default_experimental_meeting_piggyback in screenpipe-config.
+ pub experimental_meeting_piggyback: bool,
/// Experimental: request Windows WASAPI microphone AEC when the endpoint supports it.
pub windows_input_aec_enabled: bool,
/// Use Apple VoiceProcessingIO on the default macOS microphone when supported.
@@ -173,6 +177,7 @@ impl Default for AudioManagerOptions {
filter_music: false,
use_system_default_audio: true,
experimental_coreaudio_system_audio: false,
+ experimental_meeting_piggyback: false,
windows_input_aec_enabled: false,
macos_input_vpio_enabled: false,
screenpipe_aec_enabled: true,
@@ -277,6 +282,11 @@ impl AudioManagerBuilder {
self
}
+ pub fn experimental_meeting_piggyback(mut self, enabled: bool) -> Self {
+ self.options.experimental_meeting_piggyback = enabled;
+ self
+ }
+
pub fn windows_input_aec_enabled(mut self, enabled: bool) -> Self {
self.options.windows_input_aec_enabled = enabled;
self
diff --git a/crates/screenpipe-audio/src/core/process_tap/mod.rs b/crates/screenpipe-audio/src/core/process_tap/mod.rs
index 96a0eb8d2..897928184 100644
--- a/crates/screenpipe-audio/src/core/process_tap/mod.rs
+++ b/crates/screenpipe-audio/src/core/process_tap/mod.rs
@@ -10,9 +10,11 @@ mod null;
mod windows;
mod counters;
+#[cfg_attr(not(target_os = "macos"), allow(unused_imports))] // Windows consumer arrives with the deferred supervisor task
pub(crate) use counters::WatchdogCounters;
mod health;
+#[cfg_attr(not(target_os = "macos"), allow(unused_imports))] // Windows consumer arrives with the deferred supervisor task
pub(crate) use health::{classify_silence, SilenceVerdict};
#[cfg(target_os = "macos")]
diff --git a/crates/screenpipe-config/src/recording.rs b/crates/screenpipe-config/src/recording.rs
index f75085866..3321aec6a 100644
--- a/crates/screenpipe-config/src/recording.rs
+++ b/crates/screenpipe-config/src/recording.rs
@@ -161,6 +161,19 @@ pub struct RecordingSettings {
)]
pub experimental_coreaudio_system_audio: bool,
+ /// Experimental: during detected meetings, capture the meeting app's own
+ /// audio via a per-process tap plus the microphone that app actually has
+ /// open (instead of the global mix + assumed-default mic). Default `false`.
+ /// Requires macOS 14.4+ or Windows; when the platform can't do it or the
+ /// tap fails at runtime, capture automatically falls back to the stable
+ /// path (default mic + global system audio) — never less capture than
+ /// with the flag off.
+ #[serde(
+ rename = "experimentalMeetingPiggyback",
+ default = "default_experimental_meeting_piggyback"
+ )]
+ pub experimental_meeting_piggyback: bool,
+
/// Experimental: request Windows WASAPI microphone Acoustic Echo Cancellation.
/// Ignored on non-Windows platforms and fail-open when unsupported by device/driver.
#[serde(rename = "windowsInputAecEnabled", default)]
@@ -681,6 +694,7 @@ impl Default for RecordingSettings {
audio_devices: vec![],
use_system_default_audio: true,
experimental_coreaudio_system_audio: false,
+ experimental_meeting_piggyback: false,
windows_input_aec_enabled: false,
macos_input_vpio_enabled: false,
screenpipe_aec_enabled: false,
@@ -777,6 +791,13 @@ fn default_experimental_coreaudio_system_audio() -> bool {
false
}
+/// Default OFF. The per-process tap must prove itself in the field behind this
+/// opt-in before it becomes the default capture choice (rollout decision
+/// 2026-07-01). Flip deliberately, in its own PR, with TESTING.md updated.
+fn default_experimental_meeting_piggyback() -> bool {
+ false
+}
+
fn default_max_snapshot_width() -> u32 {
1920
}
@@ -937,6 +958,15 @@ mod tests {
assert_eq!(settings.port, 4040);
}
+ #[test]
+ fn meeting_piggyback_defaults_off() {
+ let config = RecordingSettings::default();
+ assert!(!config.experimental_meeting_piggyback);
+ // Posture guard: promotion to default-on must be a deliberate flip of
+ // default_experimental_meeting_piggyback, reviewed on its own.
+ assert!(!default_experimental_meeting_piggyback());
+ }
+
#[test]
fn deserializes_real_store_bin_shape() {
// Simulates the JSON shape of a real existing store.bin file.
diff --git a/crates/screenpipe-engine/src/cli/mod.rs b/crates/screenpipe-engine/src/cli/mod.rs
index d3be07e9f..6b408a5d8 100644
--- a/crates/screenpipe-engine/src/cli/mod.rs
+++ b/crates/screenpipe-engine/src/cli/mod.rs
@@ -412,6 +412,10 @@ pub struct RecordArgs {
#[arg(long, default_value_t = false)]
pub experimental_coreaudio_system_audio: bool,
+ /// Experimental: meeting-driven per-process audio capture (piggyback).
+ #[arg(long, default_value_t = false)]
+ pub experimental_meeting_piggyback: bool,
+
/// [experimental, Windows] Request WASAPI microphone AEC when supported.
/// Ignored on non-Windows platforms and unsupported endpoints.
#[arg(long, default_value_t = false)]
@@ -790,6 +794,7 @@ pub struct RecordArgSources {
pub audio_device: bool,
pub use_system_default_audio: bool,
pub experimental_coreaudio_system_audio: bool,
+ pub experimental_meeting_piggyback: bool,
pub windows_input_aec_enabled: bool,
pub macos_input_vpio_enabled: bool,
pub screenpipe_aec_enabled: bool,
@@ -846,6 +851,10 @@ impl RecordArgSources {
record,
"experimental_coreaudio_system_audio",
),
+ experimental_meeting_piggyback: from_command_line(
+ record,
+ "experimental_meeting_piggyback",
+ ),
windows_input_aec_enabled: from_command_line(record, "windows_input_aec_enabled"),
macos_input_vpio_enabled: from_command_line(record, "macos_input_vpio_enabled"),
screenpipe_aec_enabled: from_command_line(record, "screenpipe_aec_enabled"),
@@ -894,6 +903,7 @@ impl RecordArgSources {
|| self.audio_device
|| self.use_system_default_audio
|| self.experimental_coreaudio_system_audio
+ || self.experimental_meeting_piggyback
|| self.windows_input_aec_enabled
|| self.macos_input_vpio_enabled
|| self.screenpipe_aec_enabled
@@ -1073,6 +1083,7 @@ impl RecordArgs {
audio_devices: self.audio_device.clone(),
use_system_default_audio: self.use_system_default_audio,
experimental_coreaudio_system_audio: self.experimental_coreaudio_system_audio,
+ experimental_meeting_piggyback: self.experimental_meeting_piggyback,
windows_input_aec_enabled: aec_mode == screenpipe_config::AecMode::Windows,
macos_input_vpio_enabled: aec_mode == screenpipe_config::AecMode::Macos,
screenpipe_aec_enabled: aec_mode == screenpipe_config::AecMode::Screenpipe,
@@ -1303,6 +1314,9 @@ impl RecordArgs {
if sources.experimental_coreaudio_system_audio {
settings.experimental_coreaudio_system_audio = self.experimental_coreaudio_system_audio;
}
+ if sources.experimental_meeting_piggyback {
+ settings.experimental_meeting_piggyback = self.experimental_meeting_piggyback;
+ }
if sources.screenpipe_aec_enabled && self.screenpipe_aec_enabled {
settings.aec_mode = screenpipe_config::AecMode::Screenpipe;
settings.screenpipe_aec_enabled = true;
diff --git a/crates/screenpipe-engine/src/recording_config.rs b/crates/screenpipe-engine/src/recording_config.rs
index 9b1a6e478..0ba37a0bd 100644
--- a/crates/screenpipe-engine/src/recording_config.rs
+++ b/crates/screenpipe-engine/src/recording_config.rs
@@ -90,6 +90,8 @@ pub struct RecordingConfig {
pub use_system_default_audio: bool,
/// Experimental: use CoreAudio Process Tap for System Audio on macOS 14.4+.
pub experimental_coreaudio_system_audio: bool,
+ /// Experimental: meeting-driven per-process audio capture (piggyback).
+ pub experimental_meeting_piggyback: bool,
/// Experimental: request Windows WASAPI microphone AEC when supported.
pub windows_input_aec_enabled: bool,
/// Use Apple VoiceProcessingIO on the default macOS microphone when supported.
@@ -323,6 +325,7 @@ impl RecordingConfig {
audio_devices: settings.audio_devices.clone(),
use_system_default_audio: settings.use_system_default_audio,
experimental_coreaudio_system_audio: settings.experimental_coreaudio_system_audio,
+ experimental_meeting_piggyback: settings.experimental_meeting_piggyback,
windows_input_aec_enabled,
macos_input_vpio_enabled,
screenpipe_aec_enabled,
@@ -483,6 +486,7 @@ impl RecordingConfig {
.enabled_devices(audio_devices)
.use_system_default_audio(self.use_system_default_audio)
.experimental_coreaudio_system_audio(self.experimental_coreaudio_system_audio)
+ .experimental_meeting_piggyback(self.experimental_meeting_piggyback)
.windows_input_aec_enabled(self.windows_input_aec_enabled)
.macos_input_vpio_enabled(self.macos_input_vpio_enabled)
.screenpipe_aec_enabled(self.screenpipe_aec_enabled)