Rust Library

The medius crate is the official Rust client. Over a USB-serial link, it injects input alongside a real mouse, keyboard, or combo.

Property	Value
Crate version	`3.4.6`
Edition	`2024`
MSRV (minimum supported Rust version)	`1.85`
License	`MIT`
Transport	6 Mbaud, framed-only
Thread safety	`Send + Sync` (clone freely)
Safety	`#![forbid(unsafe_code)]`; on Windows, `unsafe` only in the serial read's comm-event wait

Installation

cargo add medius

With optional features:

cargo add medius --features async,mock

Feature	Description
`async`	Runtime-agnostic `AsyncDevice`, async queries.
`mock`	In-process fake box for tests.
`tracing`	Tracing across the connection lifecycle.

Getting started

Connection

Open, find, handshake

Discovery

List boxes, open by identity

API

Inject

press, release, force_release

Move

move_axis, move_rel, wheel, riding override

Lock

scale, lock, unlock, scale_all

Catch

Stream input and raw traffic

Transform

transform, untransform, query_transforms

Clip

Preload input, box-clocked playback

Requests

version, health, device info

LED

Admin

Update

update_firmware, stage_firmware, activate_firmware

Options

imperfect clones, riding, bearing, emit pace, name

Lifecycle

reapply, reconnect, session recovery

Logs & counters

Read logs, snapshot counters

Advanced control

Raw injection

Control transfers

transfer, transfer_timeout

Rewrite rules

set_rewrite, remove_rewrite, clear_rewrite

Descriptor patches

set_patch, apply_patch, clear_patch

Features

async

mock

In-process fake box

tracing

Structured diagnostics

GuidesBehaviour and how-to

Calls & input

Call kinds, async, motion, clicks

Connection

Ports, threads, keepalive

Testing

MockBox in tests

Reference

Types & errors

Enums, Result, Error