Omahub
← All plugins
T

Legion Toolkit

by tedwester

Lenovo Legion control center for Omarchy. Power modes synced with the laptop and battery panel, GPU working mode, battery charge modes, always-on USB, and cooling.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
9194221
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

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
9194221
Reviewed
1 month ago

The plugin is a transparent Lenovo Legion control widget that reads/writes sysfs nodes and uses pkexec for privileged writes, all user-initiated. No obfuscation, network access, or hidden persistence; the deterministic scan found no issues. The only risk is that it can modify hardware settings and kill processes, but that is the intended functionality and requires explicit user action.

  • Writes to sysfs and can kill processes (e.g., dGPU deactivation), but these actions are user-triggered and use pkexec for privileged writes.
  • Runs external commands like nvidia-smi and powerprofilesctl, but with fixed argument lists and no shell injection.
  • Stores state and history in ~/.config/omarchy/, which is expected and documented.
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/tedwester/omalegion --enable
Hardware #bar #power-management #system

Legion Toolkit

An Omarchy bar widget that adds a Lenovo Legion control center to the shell. Click the bar icon to open a panel with power, GPU, battery, and cooling controls synced with your laptop firmware and Omarchy's battery profile.

License: MIT.

The bar and panel logo is from LenovoLegionToolkit (assets/logo.png).

Features

Bar widget

  • Compact Legion icon on the bar with live tooltip (power mode, battery profile, CPU temperature).
  • Icon badge reflects power mode and thermal state (blue = quiet, white = balanced, accent = performance, purple = extreme/custom). Optional monochrome bar icon in the Misc tab.
  • Click to open or close the control panel.

Overview

  • Power mode, CPU/GPU temperatures, fan RPM, battery level, and GPU status at a glance.
  • Fn lock and keyboard backlight controls.

Power

  • Legion thermal modes (Quiet, Balanced, Performance, Extreme, Custom) via platform_profile, synced with Omarchy's power-profiles-daemon battery panel.
  • Custom mode PPT (power limit) tuning when supported.

GPU

  • Hybrid / dGPU-only / iGPU-only working modes.
  • dGPU deactivate, overclock controls, and active GPU process list.

Battery

  • Charge modes (normal, conservation, rapid charge, overnight).
  • Always-on USB charging toggle.

Cooling

  • Fan mode presets and manual fan speed when PWM is available.
  • Live thermal sensors and short temperature/fan history charts.

Misc

  • Monochrome bar icon toggle.
  • Plugin version and quick links.

Requirements

  • Omarchy 4 (Quattro) or newer with the current shell plugin API.
  • A Lenovo Legion laptop with Linux sysfs support (lenovo-wmi-gamezone or equivalent platform_profile interface).
  • python3 on PATH (used by the bundled hardware engine).
  • pkexec (PolicyKit) for sysfs writes when direct writes are not permitted.

Optional:

  • legion-laptop kernel module for full PWM fan curves. Without it, fan RPM is read-only on many kernels.

Installation

omarchy plugin add https://github.com/tedwester/omalegion.git --enable --yes

Omarchy clones the repository into ~/.config/omarchy/plugins/tedwester.legion/ and enables the widget on the right bar section by default.

If the icon does not appear after install:

omarchy bar put tedwester.legion --section right --after omarchy.tray

Manual installation

Copy the complete plugin directory to ~/.config/omarchy/plugins/tedwester.legion/, then run:

omarchy-shell shell rescanPlugins
omarchy plugin enable tedwester.legion --section right

Usage

  • Click the Legion icon on the bar to open or close the panel.
  • Switch tabs: Overview, Power, GPU, Battery, Cooling, Misc.
  • Changes that write to sysfs may prompt for your password via PolicyKit.
  • Press Escape to close the panel.

Uninstalling

omarchy plugin remove tedwester.legion --yes

This disables the plugin and removes it from the shell. The plugin also stores rolling thermal history at ~/.config/omarchy/legion_history.json. Delete that file manually if you no longer want the history data.

What the plugin writes

  • Sysfs nodes under /sys/ (power profile, GPU mode, battery settings, fan controls) only when you change a setting in the panel.
  • ~/.config/omarchy/legion_history.json for short in-panel temperature and fan charts.
  • ~/.config/omarchy/legion_state.json for a few panel toggles (for example GPU overclock and overnight charging).

Enabling or disabling the plugin does not modify your bar layout beyond what Omarchy's plugin enable flow already manages.