Skip to content
intekoPublic
forked from ellerotta/miyoi

About

the reverse-engineered attack shark HID protocol, macOS-only

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

miyoi

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

support

  • macOS 15 or later
  • Swift 6.3.2 or later
  • R6: wired PID 0x0021, wireless PID 0x0022
  • R5 Ultra: wired PID 0x0046, wireless PID 0x0047
  • M5 Ultra: wired PID 0x0051, wireless PID 0x0050

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

safety

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

building

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

CLI usage

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

license

licensed under the MIT License.

About

the reverse-engineered attack shark HID protocol, macOS-only

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

⌂