Omahub
← All plugins
T

Logitech G Mouse

by tantuyu

Battery, DPI, Polling Rate, and HITS analog trigger controls for Logitech G gaming mice in the Omarchy bar.

GitHub

Security review

Review recommended · 10 findings

Deterministic scan — not a security guarantee

Low
Risk level
Low
Analyzed commit
c425241
Scanned
1 week ago

Flagged patterns appear only in documentation files (README / docs) — descriptive examples, not executable code.

  • Docs sudo README.md:62

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo groupadd --system logitech-hidraw
  • Docs sudo README.md:63

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo usermod -aG logitech-hidraw "$USER"
  • Docs sudo README.md:64

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo tee /etc/udev/rules.d/42-logitech-mouse.rules << 'EOF'
  • Docs sudo README.md:67

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo udevadm control --reload
  • Docs sudo README.md:68

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo udevadm trigger
  • Docs sudo README.zh-tw.md:62

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo groupadd --system logitech-hidraw
  • Docs sudo README.zh-tw.md:63

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo usermod -aG logitech-hidraw "$USER"
  • Docs sudo README.zh-tw.md:64

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo tee /etc/udev/rules.d/42-logitech-mouse.rules << 'EOF'
  • Docs sudo README.zh-tw.md:67

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo udevadm control --reload
  • Docs sudo README.zh-tw.md:68

    Command runs with sudo, elevating the process beyond the plugin environment.

    sudo udevadm trigger

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
c425241
Reviewed
1 week ago

The plugin is a legitimate Logitech G mouse control widget that communicates with the mouse via HID++ over /dev/hidraw. The source code is clean, with no obfuscation, network activity, or destructive operations. The sudo commands flagged by the scan are documentation-only troubleshooting steps for headless systems and are not executed by the plugin itself.

  • The bundled binary `bin/logitech-g-daemon` is not directly verified against the provided Rust source in this repository, though the release workflow does verify it for releases.
  • The plugin requires access to /dev/hidraw, which is expected for hardware control and is not a security issue.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/ttymayor/oma-logitech-g-mouse --enable
Hardware #bar #quickshell

Logitech G Mouse

English | 繁體中文

An Omarchy Quattro bar widget and control panel for Logitech G gaming mice. It reads battery status and lets you adjust DPI, report rate, and—on supported mice—HITS analog-switch settings without Logitech G HUB.

Requirements

  • Omarchy Quattro on x86_64 Linux.
  • A Logitech G mouse reachable through /dev/hidraw; G304/G305 is supported through its LIGHTSPEED USB receiver.

The plugin includes its native controller. Bun, Node.js, Python, and Rust are not required to use it.

Install

From GitHub

omarchy plugin add https://github.com/ttymayor/oma-logitech-g-mouse.git --enable
omarchy restart shell

From a local checkout

mkdir -p ~/.config/omarchy/plugins/tantuyu.logitech-g-mouse
cp -a . ~/.config/omarchy/plugins/tantuyu.logitech-g-mouse/
omarchy plugin validate ~/.config/omarchy/plugins/tantuyu.logitech-g-mouse
omarchy-shell shell rescanPlugins
omarchy plugin enable tantuyu.logitech-g-mouse --section right
omarchy restart shell

Use

  • Left-click the bar widget to open the control panel.
  • Right-click it to toggle battery percentage text.
  • Use Sensor to select DPI presets, set DPI in 50-DPI steps, and choose a supported report rate.
  • Use Buttons on compatible analog-switch mice to set Actuation Point, Rapid Trigger, and Click Haptics per button.

The widget automatically reconnects after startup or a receiver reconnect. It waits up to five seconds for the receiver to become ready.

Screenshots

Sensor tab Buttons tab
Sensor tab showing battery, DPI, and polling-rate controls Buttons tab showing analog-switch button controls

Troubleshooting

On Omarchy and other systemd desktop sessions, systemd-logind normally grants the logged-in user access to /dev/hidraw* through uaccess.

If the widget stays disconnected, first check whether the native controller can see the mouse:

~/.config/omarchy/plugins/tantuyu.logitech-g-mouse/bin/logitech-g-daemon --once

If it returns EACCES: Permission denied, your session lacks HID device access. This can occur in containers, headless sessions, or systems without systemd-logind. Keep the normal uaccess path when available. For a headless system, grant access only to a dedicated local group:

sudo groupadd --system logitech-hidraw
sudo usermod -aG logitech-hidraw "$USER"
sudo tee /etc/udev/rules.d/42-logitech-mouse.rules << 'EOF'
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="046d", GROUP="logitech-hidraw", MODE="0660"
EOF
sudo udevadm control --reload
sudo udevadm trigger

Log out and back in before using the new group membership.

Uninstall

omarchy plugin disable tantuyu.logitech-g-mouse
omarchy plugin remove tantuyu.logitech-g-mouse --yes
omarchy restart shell

For a manually installed plugin:

omarchy plugin disable tantuyu.logitech-g-mouse
rm -rf "${XDG_RUNTIME_DIR:-/run/user/$UID}/omarchy-logitech-g-mouse"
omarchy restart shell

Development

See DEVELOPMENT.md for building the native controller, protocol notes, verification, and release automation.

License

MIT License. Logitech, G PRO, and SUPERSTRIKE are trademarks of Logitech. This project is an independent third-party open-source plugin and is not affiliated with Logitech.