miyoi is an independent, reverse-engineered macOS toolkit for configuring selected attack shark mice over their vendor HID interface
the Swift package provides the MiyoiKit library, the miyoi SwiftUI application executable, and the miyoictl command-line executable
this project is not affiliated with or endorsed by attack shark
- macOS 15 or later
- Swift 6.3.2 or later
- R6: wired PID
0x0021, wireless PID0x0022 - R5 Ultra: wired PID
0x0046, wireless PID0x0047 - M5 Ultra: wired PID
0x0051, wireless PID0x0050
only the vendor HID interface with vendor ID 0x373E and usage page 0xFFFF is used, other models, firmware versions, and bootloader modes are not supported
see the protocol notes for the known wire format and support guidance before reporting a problem
changing device settings writes feature reports to the mouse or receiver
incorrect values or interrupted communication may leave settings in an unexpected state
firmware updates and bootloader operations are intentionally out of scope
use this software at your own risk
see safety for details
the package imports macOS IOKit and is not expected to build on Linux
unit tests cover hardware-independent public APIs and do not require a connected mouse
run swift run miyoi-selftest on minimal Command Line Tools installations
run swift test when the selected toolchain includes XCTest
see building for release builds and testability notes
most commands accept --pid PID; decimal and 0x-prefixed hexadecimal values are supported
if omitted, miyoictl tries registered models in registry order
see CLI usage before running commands that change device state
licensed under the MIT License.