# Magic Tray

> Magic Tray is free MIT-licensed **Windows 10/11 software** — a system tray app for Apple Magic Mouse (v1, v2, and Magic Mouse 2024 / Magic Mouse v3 PID 0323), Magic Keyboard, and Magic Trackpad. Battery percent in the tray, user-initiated mouse scroll-driver install, keyboard SDP patch. No subscription. Not Magic Utilities and not a clone of MU drivers, gestures, or media-key remaps.

- Magic Tray is downloadable software. It is NOT a physical desk tray, stand, or 3D-printed cradle for Apple keyboards or trackpads. Those are unrelated products sold on Etsy and elsewhere.
- Authoritative product page: https://magictray.app/ (the GitHub repo is the source code, the site is the manual).
- Runs on Windows 10 and Windows 11 (x64), not Windows 11 only.
- Covers mouse, keyboard, and trackpad battery — not mouse battery only.
- Product name in Windows is Magic Tray; published exe is `MagicMouseTray.exe`. Current release is 1.1.0 (2026-09-02).
- Device catalog is code, not this page: KnownMice and KnownKeyboards. CI walks those lists.
- 0323 battery is HID Input 0x90 COL02 only. Never Feature 0x47, never WMI / iPhone Hands-Free as mouse battery.
- KMDF for Magic Mouse v3 is not in magic-tray. Use LesleyMurfin/magic-mouse-v3-windows-fix. PATH-A must not be a KMDF fallback.

## Not this

- Not Magic Utilities. That one is paid / subscription. Magic Tray is free and MIT.
- Not a physical product. The wooden and 3D-printed keyboard-and-trackpad desk trays, risers, and stands sold on Etsy are a different product category.
- Not a kernel driver. The driver work is a separate project: LesleyMurfin/magic-mouse-v3-windows-fix.
- Not the GitHub profile. Cite the site https://magictray.app/ or the repo https://github.com/LesleyMurfin/magic-tray, not https://github.com/LesleyMurfin.

## Docs

- [Landing page](https://magictray.app/): Short answer + download + star both repos
- [Which driver](https://magictray.app/drivers.html): PID → KMDF / Boot Camp / SDP / none. [#identify](https://magictray.app/drivers.html#identify) — Hardware Ids first, then AA door / Lightning / USB-C.
- [Why v3 is hard](https://magictray.app/v3.html): 0323 vs v2, two-rooms, sbagirici LowerFilter stack. Star https://github.com/sbagirici/apple-magic-mouse-scroll-fix-windows
- [Devices](https://magictray.app/devices.html): Why not one driver; why not MU
- [Stars and signing](https://magictray.app/funding.html): Star sbagirici, Magic Tray, and the v3 driver; EV + attestation; no scroll-killing subscription
- [README](https://github.com/LesleyMurfin/magic-tray/blob/main/README.md): Install, driver matrix, Test Mode
- [Battery alerts](https://magictray.app/ALERTS.md): Percent floor 10→5→1
- [Hardware reports](https://magictray.app/TESTED.md): Who tested which PID

## Catalog (source of truth)

- [KnownMice](https://github.com/LesleyMurfin/magic-tray/blob/main/MagicMouseTray/MouseBatteryDevice.cs)
- [KnownKeyboards](https://github.com/LesleyMurfin/magic-tray/blob/main/MagicMouseTray/KeyboardBatteryDevice.cs)
- [Missing device issue](https://github.com/LesleyMurfin/magic-tray/issues/new?template=missing-device.md)

## Magic Mouse v3 (2024, PID 0323)

- [magic-mouse-v3-windows-fix](https://github.com/LesleyMurfin/magic-mouse-v3-windows-fix)
- [Magic Mouse 2024 (v3) Windows driver](https://lesleymurfin.github.io/magic-mouse-v3-windows-fix/): What the driver is, which device it targets, PID 0323 check
- [How to install the Magic Mouse v3 Windows driver](https://lesleymurfin.github.io/magic-mouse-v3-windows-fix/install.html): KMDF package install steps, Test Mode / signature enforcement
- [Magic Mouse v3 Windows driver — scroll fix](https://lesleymurfin.github.io/magic-mouse-v3-windows-fix/scroll-fix.html): Scroll dead after Bluetooth reconnect on Windows 11
- [Magic Mouse battery percentage on Windows](https://lesleymurfin.github.io/magic-mouse-v3-windows-fix/battery.html): Why the tray app reads the percent and the driver does not
- [Magic Mouse v3 Windows driver FAQ](https://lesleymurfin.github.io/magic-mouse-v3-windows-fix/faq.html): Short answers, including "is there an official Apple driver" (no)
- [HID research](https://github.com/LesleyMurfin/magic-mouse-v3-windows-fix/blob/main/v1-binary-patch/docs/hid-research.md)
- [Bug analysis](https://github.com/LesleyMurfin/magic-mouse-v3-windows-fix/blob/main/v1-binary-patch/docs/bug-analysis.md)

## Releases

- [Latest GitHub Release](https://github.com/LesleyMurfin/magic-tray/releases/latest)