Skip to content

1.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 Jun 03:17
· 13 commits to main since this release
v1.0.0
8bda894

OpenSharkX11 v1.0.0

First public release of OpenSharkX11 — a native Linux configurator for the Attack Shark X11 tri-mode mouse. No Windows software, no Wine.

Features

Connection

  • Tri-mode auto-detect: searches 2.4 GHz dongle → USB-C cable → Bluetooth 5.0 (BLE) in sequence
  • Dedicated BT button for direct Bluetooth connection when disconnected
  • System tray with connection status and battery percentage
  • Tray "Search mouse" action reconnects without opening the window

DPI

  • 6 independent DPI stages — up to 26,000 DPI
  • Individual RGB color per stage
  • Angle Snap and Ripple Control toggles
  • Physical DPI button on mouse updates the active stage in real time

Lighting

  • 7 modes: Off · Static · Breathing · Neon · ColorBreathing · StaticDPI · BreathingDPI
  • Animation speed control (5 levels)
  • Global color picker with 12 quick swatches
  • Automatic LED override at critical battery level

Buttons

  • Remap all 8 buttons: left, right, middle, forward, backward, DPI, and extras
  • Supported actions: native mouse functions, keyboard shortcuts, multimedia keys
  • Works via 2.4 GHz dongle, USB-C, and Bluetooth

Performance

  • Polling rate: 125 / 250 / 500 / 1000 Hz
    • Locked to 125 Hz in USB-C wired mode (hardware limit)
    • Locked to 125 Hz in Bluetooth mode (BLE limit)
  • Debounce: 4–50 ms (2 ms steps)

Profiles

  • Save, load, and delete named configuration profiles
  • Profiles store DPI, lighting, button mappings, and performance settings

Battery

  • Real-time battery percentage in UI and system tray
  • Auto-refresh every 5 minutes
  • Critical battery LED override (configurable color)

Interface

  • Cockpit-style frameless window with sidebar mouse diagram
  • Accent color syncs with the active DPI stage RGB
  • 3 languages: Português · English · 中文
  • Live mode: lighting and DPI preview without clicking Apply

Bluetooth (BLE) — confirmed working

Feature Works via BLE
DPI configuration ✅
Lighting modes ✅
Debounce ✅
Button remapping ✅
Polling rate ⛔ max 125 Hz (fixed)

Installation

Arch / CachyOS (recommended)

yay -S opensharkx11-git

AppImage / .deb

Download from the releases page and install the udev rule:

sudo cp aur/99-attack-shark-x11.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger

Requirements

  • Electron 34 · libusb · BlueZ (for BLE)
  • BLE requires the mouse to be paired first: bluetoothctl pair <MAC>

Protocol

Full reverse-engineering notes for the HID and BLE protocols:
docs/protocol/PROTOCOL_EN.md

Assets 5
Loading