Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 3.3.1 instead.

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 Aug 27, 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:
  • Yanked:
Newer release available (3.3.1)

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 Aug 27, 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.0.tar.gz (276.4 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.0-py3-none-win_amd64.whl (331.2 kB view details)

Uploaded Python 3Windows x86-64

medius-3.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (865.2 kB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

medius-3.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (861.6 kB view details)

Uploaded Python 3manylinux: glibc 2.17+ ARM64

medius-3.3.0-py3-none-macosx_11_0_x86_64.whl (433.3 kB view details)

Uploaded Python 3macOS 11.0+ x86-64

medius-3.3.0-py3-none-macosx_11_0_arm64.whl (411.7 kB view details)

Uploaded Python 3macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: medius-3.3.0.tar.gz
  • Upload date:
  • Size: 276.4 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.0.tar.gz
Algorithm Hash digest
SHA256 e0f9c57bbbbc544b78e830d679ee5cc063caa232899c34e7793108b7e17f262b
MD5 6e613f5ba88431f2271e46b087044a28
BLAKE2b-256 d2a1143061e8d3efe0ed8c50215a8d77360d73e0447542902c22cd458f999c0a

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.0.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.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: medius-3.3.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 331.2 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.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 c8584e27a766788684eeb2bb4e928da4d76fde67d4611c2e1fbd80bc37982750
MD5 067ff5b3e2bfc5c92170803bc2e87542
BLAKE2b-256 d43630222d305d35fb5e4dad3abc5605f5e90fba18c832cbd013f31afc5acc61

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.0-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.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for medius-3.3.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 29be7d86c89a3fe281544ff5002aa005633be377c00a316871de2b7f192d811f
MD5 7d010e5c817fda2a69d8ff2f3a5ceb67
BLAKE2b-256 bfebaab0d1bcdea0b156f8f5ab026e1ed1cdeeae333bf41c42f3d238ec71c56a

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.0-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.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for medius-3.3.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 d5b60c2a74170ca378408f49193ca681996a64e8b6226968988f8af2617faece
MD5 163c01d6f1b50abe9689b4427fbc18bd
BLAKE2b-256 b87fa6ea594c2b5c21e012fd4a0f87354162f96888386b80a6765ac9193edb44

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.0-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.0-py3-none-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for medius-3.3.0-py3-none-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 6c839be2307166fb0324d78721100d63ce46fecbf999db194af022721d303642
MD5 12cb7d273b24b74eb184a63b1d78b4a7
BLAKE2b-256 1abcaf27db5aa3041eaad1bacbc531bb33c2a0b7dace112e02aca2fad55b9209

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.0-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.0-py3-none-macosx_11_0_arm64.whl.

File metadata

  • Download URL: medius-3.3.0-py3-none-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 411.7 kB
  • Tags: Python 3, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for medius-3.3.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 316cd78b8f7881317b17d86cacab6da36d07d0c080ae44018d22574dce4b4e9d
MD5 f4a019861babd3379685fc1221220a2d
BLAKE2b-256 b760ea5300801a0a24d4b307abd3806d763668a38c55b52373a69bf143393159

See more details on using hashes here.

Provenance

The following attestation bundles were made for medius-3.3.0-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

3.3.1

6 files

This release
Yanked

3.3.0 This release

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