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.

Project links

Data verified by PyPI on Sep 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for K4 from gravatar.com K4

Credits

Author: medius

GitHub Statistics

Data verified by PyPI on Sep 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.8

Provides Extra

test

Tags

hid makcu medius mouse serial

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

medius-3.3.1.tar.gz (285.8 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

medius-3.3.1-py3-none-win_amd64.whl (334.0 kB view details)

Uploaded Python 3Windows x86-64

medius-3.3.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (868.0 kB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

medius-3.3.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (863.7 kB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

medius-3.3.1-py3-none-macosx_11_0_x86_64.whl (429.7 kB view details)

Uploaded Python 3macOS 11.0+ x86-64

medius-3.3.1-py3-none-macosx_11_0_arm64.whl (408.9 kB view details)

Uploaded Python 3macOS 11.0+ ARM64

File details

Details for the file medius-3.3.1.tar.gz.

File metadata

  • Download URL: medius-3.3.1.tar.gz
  • Upload date:
  • Size: 285.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for medius-3.3.1.tar.gz
Algorithm Hash digest
SHA256 59fe95cca263af5a0d9771c3c0f43a6b84be0a18e908851fc813d873daad6c49
MD5 5fe6e2cdfae10227df1872a7eab05ec5
BLAKE2b-256 1fdcf5152b3b6c94cdc4b973946d0195a119f6bb17bb036312accc9dfb741639

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.1.tar.gz:

Publisher: ci.yml on K4HVH/medius

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file medius-3.3.1-py3-none-win_amd64.whl.

File metadata

  • Download URL: medius-3.3.1-py3-none-win_amd64.whl
  • Upload date:
  • Size: 334.0 kB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for medius-3.3.1-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 3ee3eff83c7faa616dfb95b24ba9f4bbc4d1cdb6d65c6a212bb606f26a9fa375
MD5 d02265504dfc3ca2742bee459e84ec82
BLAKE2b-256 7841e4b232a87b4a8dcc4f1e11f3a1211d3aded35d85edfe64d7c1a331938af3

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.1-py3-none-win_amd64.whl:

Publisher: ci.yml on K4HVH/medius

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file medius-3.3.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for medius-3.3.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 26eefed0af9b3b6206c282511a54eb11a6d955faf2f97b772d664f6d12bfbedc
MD5 16f8ad24f9ed7f44a99a05d432775548
BLAKE2b-256 e063d22fb75da9cd52ab6dbb89f8760405c0b5ada88bc3edab3e536a2970e18d

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: ci.yml on K4HVH/medius

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file medius-3.3.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for medius-3.3.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 16fa83680b0f14705e97f8e8ec911fa4d1d7ff6871ea7291e4388e3f3e0292a9
MD5 38d15d2e56e3834413fec67b7ff7b696
BLAKE2b-256 af43a2044e663994c3eda234f6d611a20ec7e33963227697aea1ffd421c99da9

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: ci.yml on K4HVH/medius

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file medius-3.3.1-py3-none-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for medius-3.3.1-py3-none-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 1e730f7db3b202627152a1e80c012c21816fe6c7cf4788d88b05c231e594fcd0
MD5 e63704d8c445b5ae3a9933da23ea3674
BLAKE2b-256 5ec6b0ee747d3eb9b48b1264d2c389138e55128bf9496f6f41994c51c2eb4bcd

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.1-py3-none-macosx_11_0_x86_64.whl:

Publisher: ci.yml on K4HVH/medius

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file medius-3.3.1-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for medius-3.3.1-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 8cbd857c7a8ccc8b8cd0d3e587b5413e8bd42fdcbe7c7ebc1af34ae07b3ad607
MD5 85f893b608db2955f29a0d310e744b1e
BLAKE2b-256 742e3267a541821d986a7b36f508fbaa437f2750f23e41eca6e6ac9e59a003be

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.1-py3-none-macosx_11_0_arm64.whl:

Publisher: ci.yml on K4HVH/medius

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

3.3.1 This release

6 files

Yanked

3.3.0

6 files

3.2.0

6 files

3.1.0

6 files

3.0.1

6 files

3.0.0

6 files

2.3.0

6 files

2.2.1

7 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