| Issue | Solution |
|-------|----------|
| Mouse moves but extra buttons don’t work | Reinstall driver; disable other mouse software (Logitech/Razer). |
| Driver fails to install on Windows | Temporarily disable antivirus / SmartScreen. Run installer as Admin. |
| macOS “unidentified developer” | Right‑click the .pkg → Open → confirm. |
| Linux not detecting custom DPI | Load bewell_hid module: sudo modprobe bewell_hid |
How to update: Download the latest version from the official website and run the installer. It usually overwrites the old files automatically.
| Feature | Supported | Notes | |---------|-----------|-------| | Left/Right button swap | ✅ | | | Side button remapping (forward/back) | ✅ | Can assign media keys, shortcuts | | DPI presets (800–6400) | ✅ | Adjustable in steps of 200 | | Polling rate (125–1000 Hz) | ✅ | Stable at 1000 Hz | | RGB lighting control | ✅ (if model has LEDs) | 4 effects (static, breath, wave, off) | | Macro recording | ⚠️ | Simple keystroke macros only (no delay editing) | | Firmware update | ✅ | Checks automatically once per week | bewell mouse driver
Cause: Corrupted driver installation or USB port power management.
Fix:
Cause: Incompatible driver version (e.g., a Windows 7 driver installed on Windows 11).
Fix:
If you are selling your mouse or switching to a different brand, completely remove the BeWell driver to avoid conflicts.
Clean Uninstall Process: