Skip to main content

medius

Python bindings for medius, custom firmware and a control library for MAKCU mouse-passthrough boxes.

A MAKCU box sits inline between a mouse and a PC: the real mouse passes through to the PC while your program injects movement, buttons, scroll, and keystrokes over USB-serial. This package drives the box from Python. It's a ctypes wrapper over the medius C ABI with no runtime dependencies, and the wheel bundles the native library, so pip install needs no Rust toolchain.

Full documentation is at medius.k4tech.net.

Install

pip install medius

Platforms without a prebuilt wheel fall back to the source distribution, which builds the library and needs a Rust toolchain.

Usage

import medius

with medius.Device.find() as dev:
    print(dev.query_version())
    dev.move_rel(100, -50)                          # relative move
    dev.press(medius.Usage.button(medius.Button.LEFT))  # force a usage down
    with dev.input_events(medius.CatchFilter.all_input()) as events:
        for event in events:                        # the user's real input, live
            ...

Calls are synchronous and each sends one firmware frame; failures raise MediusError. The API covers mouse, keyboard, and media control, plus catching physical input. See medius.k4tech.net for the full reference.

License

MIT.

Release files for medius 3.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for medius 3.4.1
File Size Uploaded
medius-3.4.1.tar.gz 437.2 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for medius 3.4.1
File
medius-3.4.1-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
medius-3.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details
medius-3.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details
medius-3.4.1-py3-none-macosx_11_0_x86_64.whl Python 3 none macOS 11.0+ x86-64 Details
medius-3.4.1-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details

Total release size: 3.8 MB

Release files / medius-3.4.1.tar.gz

Download URL medius-3.4.1.tar.gz
Size 437.2 kB
Tags Source
SHA-256 checksum
How to use checksums
36c3ac9a15194c0091f0463ad29e5c8090aa3c2c366935cf7650af4a3ca459b8
BLAKE2b-256 checksum
How to use checksums
e76a2e6f374d4b2f9668c3f8a3ac4d6ffbd4095a239e65ac0d4ea15bacc6b888
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / medius-3.4.1-py3-none-win_amd64.whl

Download URL medius-3.4.1-py3-none-win_amd64.whl
Size 440.3 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
82c40fc761a00411b111f36dbfecdfa9f3a03a543552e9ab6e8339f65e1e77de
BLAKE2b-256 checksum
How to use checksums
057ada2a0bdb6ef5b613c52e9925b2cdbf435768d9fdf1071ea3dd979dbcad8c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / medius-3.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL medius-3.4.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 967.8 kB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
468ca6cf7a86121c8d595ff4d7bf08fc699d122c14e6279ef200fb5b584f99ce
BLAKE2b-256 checksum
How to use checksums
ecc2f2ee2aae1a954169cc6f3c73d89ef358fc9c75a43b256e237eb172511e42
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / medius-3.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL medius-3.4.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 959.3 kB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
e8a6d1851094ed314ba94f2b4930cc09751f83ff9c79ef5fcd12be78ba0b6cd0
BLAKE2b-256 checksum
How to use checksums
bac5a50f2bd9ddac8539b112af27ee4b46588f79e50a835728b9c79c9841296f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / medius-3.4.1-py3-none-macosx_11_0_x86_64.whl

Download URL medius-3.4.1-py3-none-macosx_11_0_x86_64.whl
Size 529.4 kB
Tags Python 3 macOS 11.0+ x86-64
SHA-256 checksum
How to use checksums
aa104b35a8f4ff4890208ac2de523365784d4d038270b5314e45436b30a70f45
BLAKE2b-256 checksum
How to use checksums
4176dfca3fcc09544fa9ce4b59f9d2721c9f3fffaf4b1f45e07e5e934fcdeca8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release files / medius-3.4.1-py3-none-macosx_11_0_arm64.whl

Download URL medius-3.4.1-py3-none-macosx_11_0_arm64.whl
Size 501.2 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
04632d6e89e441d7e66e6b4f5bfc26c0468c49e621bc585841f4eb70e4fa2daa
BLAKE2b-256 checksum
How to use checksums
9941737bb6455a46909442c2c38cd6d8669d6dbb99ee875df7794fea5cbe4cd9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 19, 2026.

Transparency log

Release history Release notifications | RSS feed

3.4.2

6 release files

This release

3.4.1 This release

6 release files

3.3.1

6 release files

3.2.0

6 release files

3.1.0

6 release files

3.0.1

6 release files

3.0.0

6 release files

2.3.0

6 release files

2.2.1

7 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page