talk-rs 0.7.1

Voice dictation for Linux -- record, transcribe, and paste
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

//! Audio capture interfaces and implementations.

use crate::error::TalkError;
use tokio::sync::mpsc;

#[cfg(feature = "capture")]
pub mod bt_profile;
#[cfg(feature = "capture")]
pub mod cpal_capture;
pub mod encoder;
pub mod file_source;
#[cfg(feature = "capture")]
pub mod indicator;
pub mod mock;
#[cfg(feature = "capture")]
pub mod monitor_capture;
#[cfg(feature = "capture")]
pub mod pipewire_capture;
#[cfg(feature = "playback")]
pub mod player;
#[cfg(feature = "capture")]
pub mod recording_feedback;
pub mod resample;
pub mod ring_buffer;
pub mod tee;
pub mod writer;

pub use encoder::{AudioEncoder, MockEncoder, OpusEncoder};
#[cfg(feature = "playback")]
pub use player::AudioPlayer;
pub use writer::{AudioWriter, OggOpusWriter, WavWriter};

pub(crate) const CHUNK_DURATION_MS: u64 = 20;
pub(crate) const CHANNEL_CAPACITY: usize = 25;

/// Trait for audio capture from system devices.
pub trait AudioCapture: Send {
    /// Start audio capture and return a receiver for PCM samples.
    ///
    /// The receiver yields chunks of i16 PCM samples, typically 20ms each.
    fn start(&mut self) -> Result<mpsc::Receiver<Vec<i16>>, TalkError>;

    /// Stop audio capture and clean up resources.
    fn stop(&mut self) -> Result<(), TalkError>;
}