Is the G502 compatible with macOS or Linux?
Applies to: Logitech G502 Hero / G502 Lightspeed / G502 X / G502 X Plus
Last updated: May 2025
Problem
You’re using macOS or Linux and want to know whether the Logitech G502 mouse works properly on these platforms—and whether customization software like Logitech G Hub is supported.
Solution
The G502 is fully functional as a basic mouse on macOS and Linux, but advanced features like button remapping, DPI tuning, RGB control, and profiles require Logitech G Hub—which has limited support on macOS and no official support on Linux.
Platform-Specific Details
✅ macOS Compatibility
- Basic functionality (plug and play):
✔ Cursor movement
✔ Clicking and scrolling
✔ DPI works (default levels) - Software support:
✔ Logitech G Hub for macOS is available
❗ Some features may be limited or buggy (e.g., macro support, LIGHTSYNC) - G Hub Download:
https://www.logitechg.com/ghub - Important Notes for macOS:
- You must allow G Hub permissions under System Preferences > Security & Privacy
- On macOS Ventura or later, full disk access and input monitoring permissions may be needed
- G Hub does not support profile auto-switching as reliably on macOS
✅ Linux Compatibility
- Basic functionality (plug and play):
✔ Cursor movement
✔ Buttons and scrolling work as standard inputs
✔ DPI and polling rate set from onboard memory will apply - Advanced features:
❌ No official G Hub support
❌ No RGB or macro customization natively - Workaround tools (community-maintained):
libratbagwith Piper GUI- Allows DPI changes, button remaps, and LED tweaks (if supported)
- May not support all G502 models equally
📝 Summary Table
| Feature | Windows | macOS | Linux (Unofficial) |
|---|---|---|---|
| Basic mouse functions | ✅ | ✅ | ✅ |
| Logitech G Hub (official) | ✅ | ⚠️ Limited | ❌ |
| DPI/Profile customization | ✅ | ⚠️ Some | ⚠️ With Piper |
| RGB lighting control | ✅ | ⚠️ Some | ⚠️ Limited |
| Macros and app switching | ✅ | ❌ | ❌ |
Notes
- If you configure your G502 on Windows using Onboard Memory Mode, those settings will carry over to macOS and Linux automatically.
- Logitech does not provide direct technical support for Linux use.
