A modern, lightweight desktop panel to configure the Attack Shark X11 mouse on Linux, with light and dark themes, profiles and live battery status.
Add a screenshot of your own app here:
Disclaimer This is an unofficial, community project. It is not affiliated with, sponsored by or endorsed by Attack Shark. Attack Shark and its logo are trademarks of their respective owner. Use this software at your own risk.
DPI
- Up to 8 stages, from 50 to 26,000 DPI, each with its own color and on/off switch.
- Switch the active stage with one click on the home screen.
Performance
- Polling rate: 125, 250, 500 or 1000 Hz.
- Debounce time, Angle Snap and Ripple Control.
- Read-only status for Motion Sync and Lift-Off Distance.
Lighting
- Modes: static, breathing, neon, color breathing and DPI-color modes.
- Color, brightness and effect speed.
- The glow behind the mouse on the home screen follows your LED color.
Battery and power
- Live battery percentage with a charging indicator.
- Idle sleep and deep sleep timers.
Profiles
- Save the current settings under a name (for example "Competitive FPS" or "Battery saver").
- Applying a profile only writes the values that changed, with a progress bar.
Interface
- Light and dark themes with an animated switch.
- Opens in its own app-style window, with a short intro animation.
- Friendly messages when the mouse is asleep or permissions are missing.
- Backend:
atk-linux.pystarts a small HTTP server on127.0.0.1(random token per session, never exposed to the network) and talks to the mouse throughmousectl. - Frontend: the UI is a single web page opened in a Chromium-based browser in
--appmode, so it feels like a native app and uses very few resources. The server shuts down by itself when you close the window.
Only the standard Python library is used. No pip install needed.
- Linux with Python 3.8+
- mousectl installed and working
- A Chromium-based browser (Brave, Chrome or Chromium). Without one, the default browser is used.
sudo apt install git python3 pipx
git clone https://github.com/D3m0nZOnFire/mousectl
cd mousectl
./install.shMake sure ~/.local/bin is in your PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrcGrant access to the mouse (see Troubleshooting), then check that it works:
mousectl statusgit clone https://github.com/shiver00/attack-shark-x11-linux
cd attack-shark-x11-linuxRun once without installing anything:
python3 atk-linux.pyOr install a launcher in your application menu:
python3 atk-linux.py --instalarThen open Attack Shark X11 from the menu.
The panel works without any images (it shows a text logo and a simple mouse drawing). To use your own, put these files next to atk-linux.py before running --instalar:
| File | Purpose |
|---|---|
atk-logo.svg (or .png) |
Logo in the sidebar and as app icon |
atk-logo-dark.svg (or .png) |
Optional light logo for dark mode. If missing, the normal logo is inverted to white |
atk-mouse.png |
Mouse picture on the home screen (transparent PNG works best) |
These files are not included in this repository, because they are the property of Attack Shark.
| Path | Content |
|---|---|
~/.config/atk-linux/profiles.json |
Your saved profiles |
~/.local/share/atk-linux/ |
Logo and mouse images |
~/.local/bin/atk-linux |
Installed copy of the script |
~/.local/share/applications/atk-linux.desktop |
Menu launcher |
rm -f ~/.local/bin/atk-linux ~/.local/share/applications/atk-linux.desktop
rm -rf ~/.local/share/atk-linux ~/.config/atk-linuxPermission denied when opening the mouse
mousectl install-udevRun the two sudo commands it prints, then unplug and replug the USB dongle or cable.
The mouse does not respond
The mouse sleeps to save battery. Move it or click a button, then press Try again in the panel.
The window does not open
Check that python3 --version is 3.8 or newer. If no Chromium-based browser is found, the panel opens in your default browser instead.
Battery shows "in use" while charging
The panel treats a wired connection below 100% as charging. If the mouse reports something else, open an issue with the output of mousectl status --json.
- Button remapping and macros are not available, because
mousectldoes not expose them for the X11. - Developed and tested with the Attack Shark X11 on Zorin OS (Ubuntu-based). Other distributions should work but are untested.
- mousectl by D3m0nZOnFire does all the communication with the mouse. This project is only a graphical layer on top of it.
Distributed under the MIT License. See LICENSE for details.
