Struct Args 

pub struct Args {
    pub debounce_time: Duration,
    pub near_miss_threshold_time: Duration,
    pub log_interval: Duration,
    pub log_all_events: bool,
    pub log_bounces: bool,
    pub list_devices: bool,
    pub stats_json: bool,
    pub verbose: bool,
    pub ring_buffer_size: usize,
    pub debounce_keys: Vec<u16>,
    pub ignore_keys: Vec<u16>,
    pub otel_endpoint: Option<String>,
}

An Interception Tools filter to eliminate keyboard chatter (switch bounce). Reads Linux input events from stdin, filters rapid duplicate key events, and writes the filtered events to stdout. Statistics are printed to stderr on exit.

Fields

debounce_time: Duration

Debounce time threshold (milliseconds). Duplicate key events (same keycode and value) occurring faster than this threshold are discarded. (Default: 25ms). The “value” refers to the state of the key: 1 for press, 0 for release, 2 for repeat. Only press and release events are debounced. Accepts values like “10ms”, “0.5s”.

near_miss_threshold_time: Duration

Threshold for logging “near-miss” events. Passed key events occurring within this time of the previous passed event are logged/counted. (Default: 100ms) Accepts values like “100ms”, “0.1s”.

log_interval: Duration

Periodically dump statistics to stderr. (Default: 15m). Set to “0” to disable periodic dumps. Accepts values like “60s”, “15m”, “1h”.

log_all_events: bool

Log details of every incoming event to stderr ([PASS] or [DROP]).

log_bounces: bool

Log details of only dropped (bounced) key events to stderr.

list_devices: bool

List available input devices and their capabilities (requires root).

stats_json: bool

Output statistics as JSON format to stderr on exit and periodic dump.

verbose: bool

Enable verbose logging (internal state, thread startup, etc).

ring_buffer_size: usize

Size of the ring buffer for storing recently passed events (for debugging). Set to 0 to disable. (Default: 0).

debounce_keys: Vec<u16>

Key codes or names to debounce. When present, only these keys are debounced (all others pass through). Takes precedence over --ignore-key. Example: --debounce-key KEY_ENTER (repeat flag for multiple keys).

ignore_keys: Vec<u16>

Key codes or names to ignore (never debounce) unless they also appear in --debounce-key. Example: --ignore-key 114 or --ignore-key KEY_VOLUMEDOWN.

otel_endpoint: Option<String>

OTLP endpoint URL for exporting traces and metrics (e.g., “http://localhost:4317”).

Trait Implementations

impl Args for Args

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Clone for Args

fn clone(&self) -> Args

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CommandFactory for Args

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl Debug for Args

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&Args> for Config

fn from(a: &Args) -> Self

Converts to this type from the input type.

impl FromArgMatches for Args

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for Args

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.