Open source · No account · No telemetry
Drop Lenovo Vantage. Keep Fn+Q, RGB, fan curves, and dGPU control. UDT is a GPL-3.0 Windows toolkit: no background service, no Lenovo account. Unsupported machines hide hardware toggles instead of pretending they work.
Install: Releases
Dark-mode console with UDT's own accent -- not a Windows-blue overlay. Star the repo if this replaced Vantage for you; that is the fastest way the next Legion owner finds it.
30 seconds, English voiceover: open source, no account, no telemetry. Play the MP4 · 中文版
Universal Device Toolkit (UDT, formerly Lenovo Legion Toolkit) is a lightweight Windows device utility that keeps hardware control direct on supported machines. On unsupported PCs it enters basic mode: hardware toggles stay hidden so the UI does not fake Vantage-class control. It runs without background services, keeps typical memory around 400MB (Electron UI + .NET Host), contains no telemetry, and focuses on native device control rather than being a general Windows toolbox.
UDT is an actively maintained GPL-3.0 project focused on compatibility updates, security hardening, CI/release automation, newer device detection, and ongoing Windows support. Existing Lenovo Legion Toolkit users keep their settings and data when upgrading; package-manager identities split in 6.x (winget SSC-STUDIO.UniversalDeviceToolkit, Scoop universaldevicetoolkit), so legacy package IDs do not upgrade in place. The supported product is Windows-first: GitHub Releases ship Windows NSIS Full/Online installers with a self-contained win-x64 Host. macOS and Linux are experimental (Electron shell, portable Host, and CrossPlatform diagnostics CLI) and have no official Electron release until those pipelines exist. Android and mobile companion applications are out of scope and are not supported.
Note
What "Universal" means UDT is extensible hardware control with a safe fallback: full hardware control targets supported Lenovo Legion, LOQ, and IdeaPad Gaming machines, plus other brands only where a tested provider exists; basic mode hides unsupported hardware toggles instead of promising Vantage-class control on every PC. The name is not a claim that UDT is a general Windows utility platform.
Important
The plugin system was retired in 6.1. All former plugin capabilities now live as built-in features (cursor & pointer controls on the Mouse page; network acceleration under System Optimization → Network & acceleration). Existing %LOCALAPPDATA%\UniversalDeviceToolkit\plugins data is no longer loaded. See CHANGELOG.
| UDT | Lenovo Vantage | |
|---|---|---|
| Background service | None | Required |
| Telemetry / Lenovo account | None | Required |
| Open source (GPL-3.0) | Yes | No |
| Built-in extras (mouse, network accel.) | Yes | Limited |
| CLI & automation | Yes | No |
| Useful on non-Lenovo PCs | Basic mode | No |
Who it's for
- Legion / LOQ owners who want to drop Vantage but keep Fn+Q, RGB, and dGPU controls
- Owners of unsupported machines who want those hardware items hidden honestly (basic mode)
- People and agents sharing
udt(app running, Settings → CLI on;udt-clistill works as an alias), plus GPL source you can actually read
Ready-to-post copy: PROMOTION_EN.md · PROMOTION_CN.md · posting playbook COMMUNITY_OUTREACH.md
| Feature | Description |
|---|---|
| 🔥 Power & Performance | Fn+Q power modes, Custom Mode with fan curves, CPU/GPU power limits |
| 🌈 RGB & Lighting | Spectrum per-key RGB, 4-zone RGB, white backlight, boot logo |
| 🎮 GPU Control | dGPU/discrete GPU toggle, MUX switch, overclock, deactivate dGPU |
| 🔌 Battery Care | Conservation mode, 60%/80% charge thresholds, real-time wear rate & health rating |
| 🧹 Deep Cache Cleanup | One-click cleanup for DirectX/Vulkan shader caches, WeChat/QQ caches & dev package manager caches |
| 🎛️ Quick Tray Control | Instant flyout with power mode segment pills & battery badge right from the system tray |
| ⚡ Actions & Macros | Presets for Mobile Eco, AC High Performance, Game Boost; JSON & clipboard sharing |
| 🖥️ Sensors | Real-time CPU/GPU temp, fan speed, clock monitoring |
| 🖱️ Cursor & Pointer | Custom cursor themes with per-UI-scale sizing (built-in) |
| 🌍 78+ Languages | Full localization with community translations |
| 📦 Ultra-Lean Footprint | Deep tray sleeping, zero background services, no telemetry, no account |
Many users and developers associate web-based desktop frameworks (Electron / Chromium) with bloated memory usage, sluggish startup, and frame drops.
However, architectural discipline and deep engineering optimizations make all the difference. UDT uses a decoupled Modern Electron Frontend + Headless .NET 10 Backend architecture with stringent performance controls:
- Frontend (Electron + React 19 + TypeScript): Focused solely on high-DPI responsive layout, Windows 11 Mica material styling, smooth animations, and dynamic 78+ language switching.
- Backend (.NET 10 / C# 13 Headless Host): All low-level hardware control (WMI/ACPI, kernel driver communication, power policy dispatch, real-time sensor polling, and automation pipelines) executes in high-performance native .NET and communicates with the UI over lightweight stdio JSON-RPC.
- 🍃 Zero-Memory Tray Sleeping: When minimized or closed to the tray, UDT completely destroys the main window and Chromium renderer DOM tree rather than just hiding it. The tray popup itself is auto-unloaded on idle. Idle background footprint stays minimal.
- ⚡ Sub-400ms Median Ready Latency:
Automated UI benchmark testing (
Tools/UiPerformance.Smoke) confirms that all page transition and ready latencies stay within ≤ 400ms, earning the highest Excellent performance rating. - 🎯 Hot-Path Zero Allocation:
High-frequency sensor graphs and UI refresh loops reuse static ECharts options and mappings via
useMemoand static caches, streaming data incrementally to eliminate garbage collection pauses. - 📦 Strict Dependency Graph Pruning:
Built with
electron-vitewith graph-based code splitting and tree-shaking; 7,000+ Fluent UI icons are strictly imported per glyph. - 🛡️ Zero Windows Services & Zero Telemetry: No persistent background Windows services installed, no telemetry data collected or transmitted.
| Metric | Legacy WPF Client | Lenovo Vantage / Legion Zone | UDT 6.0 (Tuned Electron + .NET 10) | Evaluation |
|---|---|---|---|---|
| Background Services | 0 | 3~5 persistent services | 0 (Zero Services) | Never burdens background gaming or startup |
| Cold Startup Ready Latency | 1.8s ~ 2.5s | 4.0s ~ 8.0s+ | ≤ 400ms (Median) | VS Code-level instant launch |
| Tray Idle Memory Footprint | 150MB ~ 250MB | 300MB ~ 600MB+ | 30MB ~ 60MB (DOM Destroyed) | Far lower than WPF (~70% reduction) |
| Active Peak Working Set | 180MB ~ 300MB | 500MB ~ 1.2GB | 30MB ~ 300MB (field measured) | Varies with pages; still well below Vantage |
| UI Scaling & High-DPI | Blurry text / layout clipping | Poor | Vector Pixel-Perfect (80%~150%) | Crisp on OLED, 2K & 4K displays |
| Dynamic i18n Switching | Requires app restart | Requires reload | Instant live hot-switch (78+ locales) | Seamless multi-language experience |
- Trailer
- Key Features at a Glance
- Why choose UDT?
- Disclaimer
- Download
- Quick Start
- Compatibility
- Features
- Donate
- Credits
- FAQ
- Arguments
- How to collect logs?
- Localization
- Documentation
- Contribution
The tool comes with no warranty. Use at your own risk.
Please be patient and read through this readme carefully - it contains important information.
Tip
If you are looking for a Vantage alternative for Linux, check LenovoLegionLinux project out.
Use the current SSC-STUDIO/UniversalDeviceToolkit releases for maintained builds. 6.x is a package-manager breaking change: winget moves to SSC-STUDIO.UniversalDeviceToolkit and Scoop to universaldevicetoolkit; the legacy package IDs are not upgraded in place.
Note
Current stable release: v6.1.1. Application releases use the normal vX.Y.Z tags. Legacy plugin catalog releases (plugin-catalog / plugin-catalog-preview) are historical archives only — the plugin system was retired in 6.1 and hosts no longer read them.
Note on winget: the 6.x package id SSC-STUDIO.UniversalDeviceToolkit is reserved but not yet published to winget-pkgs, so the winget install command will not resolve until that submission ships, and the legacy Lenovo Legion Toolkit package does not upgrade in place. Use Releases in the meantime.
- GitHub Releases: Download the latest Full or Online installer from Releases. Full is a complete offline NSIS installer (Electron + self-contained .NET Host). Online is a small stub (about 15MB or less) that downloads the same runtime during setup; language and device packs still install from the in-app catalog. Always install the newest version from the latest release page; settings and data migrate automatically, while package-manager installs must switch to the new 6.x IDs.
- Full ships many satellite languages offline. Online ships English by default and downloads optional language packs only when you choose them (startup language window or Settings).
- Offline /
--safe-start/ no network: the app continues in English — it does not phone home for language packs unless you start an install. - Catalog downloads use HTTPS (or your configured catalog URL). Packages are verified with SHA-256 before install. No account, no telemetry.
- Corporate proxy: set system proxy as usual, or point
UDT_RESOURCE_CATALOG_URLat an internal catalog mirror for air-gapped installs. SeeDocs/LanguagePacks.md. winget (pending): the 6.xPackageIdentifierisSSC-STUDIO.UniversalDeviceToolkit; the manifest has not been submitted to microsoft/winget-pkgs yet, sowinget installfails until it ships. The legacy Lenovo Legion Toolkit package does not upgrade in place. Use Releases today; this bullet becomes a one-line install again once the winget-pkgs PR merges.Scoop: theSSC-STUDIO/scoop-bucketmanifest repository has not been created yet, so there is no working Scoop bucket to add. Use Releases until the bucket is published.- Checksum: Each GitHub release includes a
SHA256.txtfile. Verify downloaded installers before sharing mirrors.
During the rename from Lenovo Legion Toolkit, runtime identifiers intentionally stay compatible so existing settings carry over. Package-manager identities are the exception — 6.x introduces new IDs and no in-place upgrade:
| What you see | Legacy identifier | Why it remains |
|---|---|---|
| Product name in UI / Releases | Universal Device Toolkit (UDT) | Current public branding |
| winget ID (pending) / Scoop ID | SSC-STUDIO.UniversalDeviceToolkit (new 6.x ID, not yet in winget-pkgs) / universaldevicetoolkit (new 6.x Scoop name) |
6.x package break; legacy SSC-STUDIO.LenovoLegionToolkit / lenovolegiontoolkit do not upgrade in place |
| CLI executable | udt.exe (udt-cli.exe alias for one train) |
Short name; old scripts keep working |
| Data directory | %LOCALAPPDATA%\UniversalDeviceToolkit |
Settings migrate automatically |
| Action env vars | LLT_* + UDT_* (dual-write) |
Existing user scripts; UDT aliases available |
| Core assemblies | UniversalDeviceToolkit.Lib* (primary) |
Phase 3 ABI naming carried forward |
Repository folders use UniversalDeviceToolkit.*. New users install UDT from Releases; legacy names above are compatibility aliases, not a separate product.
UDT works best when it's running in the background, so go to Settings and enable Autorun and Minimize on close. Next thing is to either disable Vantage and Hotkeys or just uninstall them. After that UDT will always run on startup and will take over all functions that were handled by Vantage and Hotkeys.
Warning
If you close UDT completely some functions will not work, like synchronizing Windows Power Modes or Windows Power Plans with current Power Mode, Macros or Actions. This is due to the fact that UDT does not run any background services and won't be able to respond to changes.
- Install UDT - Download from Releases or upgrade directly from an existing Lenovo Legion Toolkit installation
- Configure Settings - Enable "Autorun" and "Minimize on close" in Settings
- Disable Conflicts - Uninstall or disable Lenovo Vantage and Hotkeys
- Explore Features - Supported Lenovo hardware controls, system optimization, cursor & pointer themes, language packs, themes, and logs
Tip
First time? Check out the User Guide for detailed walkthroughs.
If you installed UDT on a clean Windows install and want Lenovo hardware controls, make sure to have necessary Lenovo drivers installed. If drivers are missing, hardware-specific options might not be available. Especially make sure that these two are installed on supported Lenovo systems:
- Lenovo Energy Management
- Lenovo Vantage Gaming Feature Driver
If for whatever reason the UDT installer did not setup .NET properly:
- Go to https://dotnet.microsoft.com/en-us/download/dotnet/10.0
- Find section ".NET Desktop Runtime"
- Download x64 Windows installer
- Run the installer
After following these steps, you can open Terminal and type: dotnet --info. In the output look for section .NET runtimes installed, in this section you should see entries for the installed runtime such as Microsoft.NETCore.App 10.x.x and Microsoft.WindowsDesktop.App 10.x.x under C:\Program Files\dotnet\shared.
Universal Device Toolkit now uses catalog-backed device support. Supported Lenovo gaming and creator machines get hardware controls; unsupported Lenovo models and non-Lenovo PCs enter basic mode so unavailable hardware entries stay hidden. Language, theme, update, log, and safety workflows may still be present — they are not the reason to install UDT.
Hardware-control families:
- Legion 5, Legion Slim 5, Legion Pro 5
- Legion 7, Legion Pro 7, Legion 9
- Legion Go
- LOQ
- IdeaPad Gaming, ThinkBook, YOGA, and selected legacy Lenovo gaming families
- Chinese variants such as R7000/R7000P/R9000/Y7000/Y7000P/Y9000, including Y7000P 2020H
Basic-mode families:
- Lenovo ThinkPad, ThinkCentre, ThinkStation, IdeaCentre, Legion desktop, XiaoXin, V series, Slim, and other unmatched Lenovo models
- Motorola, ASUS, Dell, HP, Acer, MSI, Microsoft Surface, GIGABYTE/AORUS, Razer, Samsung Galaxy Book, Apple Mac, HUAWEI MateBook, Xiaomi/RedmiBook, realme Book, Infinix INBook, HONOR MagicBook, LG gram, Framework, Panasonic TOUGHBOOK, Dynabook/Toshiba, Fujitsu, VAIO, Gateway, CHUWI, TECLAST, Jumper, MEDION/ERAZER, XMG/SCHENKER, System76, Star Labs, Slimbook, Hasee, THUNDEROBOT, MACHENIKE, COLORFUL, MAIBENBEN, MECHREVO, Clevo/Tongfang barebones, handheld PCs such as Steam Deck/GPD/AYANEO/ONEXPLAYER, mini PCs such as MINISFORUM/Beelink/GEEKOM/ZOTAC, and generic PCs
Hardware-control matching is driven by UniversalDeviceToolkit.Lib/DeviceSupport/LenovoDeviceSupportProvider.cs and online data-only device packs. Generations 6 (MY2021), 7 (MY2022), 8 (MY2023), 9 (MY2024) and newer are the primary Lenovo hardware-control target. Some features may also work on selected 5th generation (MY2020) devices. Basic-mode vendor matching normalizes common BIOS/DMI formatting differences, so punctuation, casing, spacing, diacritics, and company suffix variants do not usually block a match.
If UDT starts in basic mode, it is doing that intentionally to avoid showing unsupported hardware controls. Do not expect Vantage-class hardware control there. Logs and device-pack data for a tested provider are the path to broader hardware support.
UDT is a Windows-first product. Official GitHub Releases publish Windows
NSIS Full/Online installers with a self-contained win-x64 Host
(Release.yml). There is no official macOS or Linux Electron release
until those pipelines exist.
What exists today for macOS/Linux is experimental developer surface, not a shipped product:
UniversalDeviceToolkit.CrossPlatformdiagnostics CLI (CI-tested)- Portable
net10.0libraries and a portable Host built withUDTWindows=false/UDT_PLATFORM=linux|macos(build.sh host) - Electron shell code that adapts title bar, menu, tray, and OSD chrome
The portable Host answers most Windows-only RPC names as -32099
(Not supported on this platform.).
Do not treat local npm run dist:mac / npm run dist:linux output as
official release artifacts.
| Capability | Windows (supported) | macOS / Linux (experimental) |
|---|---|---|
| Lenovo hardware control (Fn+Q, RGB, fan curves, dGPU, battery care) | Yes | No |
| Windows system optimization | Yes | No (portable Host stubs those domains) |
| Themes, in-app updates, logs UI | Yes | Shell may render; no official update channel or release assets |
| Title bar / menu / tray / OSD chrome | Yes | Shell code exists; not a shipped product |
| Restart / shutdown / sleep actions | Yes | No |
| Windows power plan switching | Yes | No |
Note
Restart/shutdown/sleep and Windows power-plan switching use Windows-only
tools (shutdown.exe, powercfg) in the Electron main process.
The OSD window itself is Electron chrome; sensor values come from the Host
and are only meaningful on Windows.
Build the Electron client (Windows product path)
cd UniversalDeviceToolkit.Electron
npm ci # first time only (uses package-lock.json)
npm run dev # dev server + Electron window (hot reload)
npm run dist:win # Windows NSIS installer (x64); used by official releasesnpm run dist:mac and npm run dist:linux are experimental local
packaging scripts. They expect a portable Host already published under
UniversalDeviceToolkit.Host/publish/osx-* or linux-x64. Release.yml
does not run them and does not attach DMG/AppImage/DEB assets.
Experimental portable Host (not a release artifact):
# Linux x64
UDT_PLATFORM=linux ./build.sh host
# macOS (auto-detects osx-arm64 or osx-x64)
UDT_PLATFORM=macos ./build.sh hostOr the equivalent dotnet publish with -p:UDTWindows=false. Publishing
the default Windows TFM (net10.0-windows10.0.26100.0) for osx-* /
linux-x64 is not a supported product path. See
DEPLOYMENT.md.
The repository also includes UniversalDeviceToolkit.CrossPlatform, a plain
net10.0 CLI entry point for local macOS/Linux and Windows diagnostics (see
DEPLOYMENT.md for build details):
Cross-platform CLI commands (developers)
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- status
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- json
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- hardware
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- telemetry
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- power
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- profile
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- controls
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- elevate set cpu-governor performance
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- support
dotnet run --project UniversalDeviceToolkit.CrossPlatform -- doctorOn macOS/Linux this CLI reports platform/runtime information, reads basic hardware identity from Linux DMI (/sys/class/dmi/id) or macOS sysctl/system_profiler, reads safe CPU/memory/frequency/temperature/fan telemetry from Linux procfs/sysfs or macOS sysctl, reads battery and external power state from Linux power_supply or macOS pmset, inspects platform power profiles through Linux powerprofilesctl or macOS pmset, matches common vendors to safe basic device packs, and treats the machine as safe basic mode. The doctor command aggregates readiness checks into a pass/warn/fail report. Vendor-specific control backends are future expansion points.
Overall the recommendation is to disable or uninstall Vantage, Hotkeys and Legion Zone while using UDT. There are some functions that cause conflicts or may not work properly when UDT is working along side other Lenovo apps.
Tip
Using the disable option in UDT is often the easiest option.
UDT currently does not support installation for multiple users, so if you need to have multiple users on you laptop you might encounter issues. Same goes for accounts without Administrator rights - UDT needs an account with Administrator rights. If you install UDT on an account without such rights, UDT will not work properly. Multi-user support is on the long-term roadmap.
Note
Warranty lookup (China region): Warranty status for Chinese Legion models was removed in recent versions due to unreliable upstream APIs. Existing cached data may still display until refreshed or cleared.
The app allows to:
- Deep System Junk & Shader Cache Cleaning: Scan and clean DirectX/Vulkan shader caches, WeChat/QQ temp caches, package manager caches (npm/yarn/pnpm/cargo/pip), and Windows thumbnail/temp files.
- Battery Health & Wear Level Real-Time Monitoring: Accurately calculate design capacity, full charge capacity, cycle count, and wear percentage with health ratings.
- Automation Preset Templates & Cross-Device Sharing: Built-in presets for battery conservation, gaming performance, and quiet work; full JSON export/import and clipboard sharing.
- Enhanced Tray Quick Controls Flyout: Capsule segmented power mode switcher, battery percentage badge, and instant hardware status.
- Hardware Modes & Fan Curves: Change performance modes, battery conservation/rapid charge, and customize fan curves on 2022+ models.
- Full Keyboard & Lighting Control: Spectrum per-key RGB, 4-zone RGB, white backlight, logo light, and rear port lighting.
- Dedicated GPU Hybrid Mode & Kill Switch: Switch between Hybrid/dGPU-only modes, track active GPU processes, and forcefully sleep inactive NVIDIA dGPUs.
- Automation Pipeline & Macro Sequences: Automate triggers based on AC power, active applications, external displays, Wi-Fi, time of day, and custom hotkeys.
- Zero Background Services: Disable Lenovo Vantage / Legion Zone services cleanly without uninstallation.
Located under Windows Optimization → System & Storage:
- 🎮 DirectX & Vulkan Shader Caches: Safely purge DirectX D3DSCache and NV_Cache to resolve corrupted shader stutters or reclaim multiple gigabytes of disk space.
- 💬 Instant Messaging Caches (WeChat / QQ): One-click clean temporary media, avatar caches, and discarded file transfers.
- 💻 Package Manager Caches: Clean global cache bloat for
npm,pnpm,yarn,cargo, andpipdevelopment environments. - 🧹 System Thumbnails & Temp Files: Clear Windows thumbnail database caches and orphaned temporary directories.
Located under Dashboard → Battery Details:
- Real-Time Health Rating: Dynamically evaluates current battery capacity against original factory design capacity (Excellent ≥ 90%, Good ≥ 80%, Service Recommended < 80%).
- Multi-Metric Telemetry: Real-time charge/discharge rate (mW/W), ambient temperature, cycle counts, manufacture date, and first-use timestamp.
Located under Automation and Keyboard Macro:
- Built-in Standard Presets: Instantly apply tested automation workflows (e.g. "Auto Switch to Quiet & 60Hz on Battery", "High Refresh Rate & Beast Mode on AC").
- Cross-Device Config Sharing: Export/import automation pipelines and macro sequences as JSON, or share directly via clipboard copy/paste.
- Click the taskbar tray icon for an instant, responsive flyout:
- Segmented Capsule Controls: Instant 1-click switching between Quiet, Balance, and Beast modes.
- Battery Badge: Live battery percentage, conservation mode status, and charging rate.
- Zero-Resident Idle: Unloads completely when closed, leaving zero persistent memory footprint.
The Mouse page includes built-in cursor & pointer controls: custom high-DPI cursor themes with per-UI-scale sizing and pointer speed adjustments. (This was previously delivered by the CustomMouse plugin before the plugin system was retired.)
Custom Mode is available on all devices that support it. You can find it in the Power Mode dropdown as it basically is 4th power mode and it allows for adjusting power limits and fans. Custom Mode can't be accessed with Fn+Q shortcut. Not all features of Custom Mode are supported by all devices.
If you have one of the following BIOSes:
- G9CN (24 or higher)
- GKCN (46 or higher)
- H1CN (39 or higher)
- HACN (31 or higher)
- HHCN (20 or higher)
Make sure to update it to at least minimum version mentioned above for Custom Mode to function properly.
Both Spectrum per-key RGB and 4-zone RGB backlight is supported. Vantage and it's services need to be disabled to avoid conflicts when communicating with hardware. If you use other RGB apps that might conflict with UDT, check FAQ for solutions.
Other lighting features like both 1 and 3 level white keyboard backlight, panel logo and rear ports backlight are also supported, however there are some constraints:
- GKCN54WW and lower - some lighting features are disabled due to a bug in these BIOS versions causing BSOD
- some (mostly Gen 6) laptops models might not show all options or show options that aren't there - this is due misconfigured BIOS that doesn't report availability of these features
Lighting that required Corsair iCue is not supported by UDT.
Important
Riot Vanguard DRM (used in Valorant for example) is known to cause issues with RGB controls. If you don't see RGB settings and have it installed, make sure it doesn't run on startup or uninstall it._
Note
Hybrid Mode/GPU Working Mode options are not Advanced Optimus and work separately from it.
There are two main way you can use your dGPU:
- Hybrid mode on - internal laptop display is connected to integrated GPU, discrete GPU will work when needed and power off when not in use, giving better battery life
- Hybrid mode off (aka dGPU) - internal laptop display is conenected directly to discreted GPU, giving best performance but also worst battery life
Switching between two modes requires restart.
On Gen 7 and 8 laptops, there are additional 2 settings for Hybrid mode:
- Hybrid iGPU-only - in this mode dGPU will be disconnected (think of it like ejecting USB drive), so there is no risk of it using power when you want to achieve best battery life
- Hybrid Auto - similar to the above, but tries to automate the process by automatically disconnecting dGPU on battery power and reconnecting it when you plug in AC adapter
Discrete GPU may not disconnect, and in most cases will not disconnect, when it is used. That includes apps using dGPU, external monitor connected and probably some other cases that aren't specified by Lenovo. If you use the "Deactivate GPU" option in UDT, make sure that it reports dGPU Powered Off and no external screens are connected, before switching between Hybrid Modes in case you encounter problems.
All above settings are using built in functions of the EC and how well they work relies on Lenovo's firmware implementation. From my observations, they are reliable, unless you start switching them frequently. Be patient, because changes to this methods are not instantanous. UDT also attempts to mitigate these issues, by disallowing frequent Hybrid Mode switching and additional attempts to wake dGPU if EC failed to do so. It may take up to 10 seconds for dGPU to reappear when switching to Hybrid Mode, in case EC failed to wake it.
If you encounter issues, you might try to try alternative, experimental method of handling GPU Working Mode - see Arguments section for more details.
Warning
Disabling dGPU via Device Manager DOES NOT disconnect the device and will cause high power consumption!
Sometimes discrete GPU stays active even when it should not. This can happen for example, if you work with an external screen and you disconnect it - some processes will keep running on discrete GPU keeping it alive and shortening battery life.
There are two ways to help the GPU deactivate:
- killing all processes running on dGPU (this one seems to work better),
- disabling dGPU for a short amount of time, which will force all processes to move to the integrated GPU.
Deactivate button will be enabled when dGPU is active, you have Hybrid mode enabled and there are no screens connected to dGPU. If you hover over the button, you will see the current P state of dGPU and the list of processes running on it.
Note
Some apps may not like this feature and crash when you use deactivate dGPU option.
The overclock option is intended for simple overclocking, similar to the one available in Vantage. It is not intended to replace tools like Afterburner. Here are some points to keep in mind:
- Make sure GPU overclocking is enabled in BIOS, if your laptop has such option.
- Overclocking does not work with Vantage or LegionZone running in the background.
- It is not recommended to use the option while using other tools like Afterburner.
- If you edited your Dashboard, you might need to add the control manually.
First of all, the Power Mode you see in UDT (or toggle with Fn+Q) is not the same as Power Plans (that you access from Control Panel) or Power Mode (that you can change from Settings app).
The modern (and recommended) approach is to use Windows Power Modes and only one, default, "Balanced (recommended)" power plan. You should have 3 Power Modes to choose from in Windows Settings app:
- Best power efficiency
- Balanced
- Best performance
You can assign these in UDT settings to each of Legion Power Modes: Quiet, Balance, Performance and Custom. If you choose to do so, respective Windows Power Mode will be automatically set when you change Legion Power Modes.
The legacy approach is to use multiple Power Plans, that some devices had installed from factory. If you decide to use them, or configure your own plans, leave the settings in Windows Settings app on the default "Balanced" setting. You can configure UDT to switch Power Plans automatically whenever you change the "Legion" Power Mode in UDT settings.
If you encounter issues with power mode or plan synchronization, especially when switching between the two approaches, you can reset Windows power settings to default using powercfg -restoredefaultschemes; shutdown /r /t command. This command will reset all power plans to default and reboot your device. All plans except for the default "Balanced (recommended)" will be deleted, so make sure to make a copy, if you plan on using them again.
On some laptops, it is possible to change the boot logo (the default "Legion" image you see at boot). Boot logo is not stored in UEFI - it is stored on the UEFI partition on boot drive. When setting custom boot logo, UDT conducts basic checks, like resolution, image format and calculates a checksum to ensure compatibility. However, the real verification happens on the next boot. UEFI will attempt to load the image from UEFI partition and show it. If that fails for whatever reason, default image will be used. Exact criteria, except for resolution and image format, are not known and some images might not be shown. In this case, try another image, edited with different image editor.
You can use "Run" step in Actions to start any program or script from Actions. To configure it, you need to provide path to the executable (.exe) or a script (.bat). Optionally, you can also provide arguments that the script or program supports - just like running anything from command line.
Examples
Shutdown laptop
- Executable path:
shutdown - Arguments:
/s /t 0
Restart laptop
- Executable path:
shutdown - Arguments:
/r
Runing a program
- Executable path:
C:\path\to\the\program.exe(if the program is on your PATH variable, you can use the name only) - Arguments:
(optional, for list of supported argument check the program's readme, website etc.)
Running a script
- Executable path:
C:\path\to\the\script.bat(if the script is on your PATH variable, you can use the name only) - Arguments:
(optional, for list of supported argument check the script's readme, website etc.)
Python script
- Executable path:
C:\path\to\python.exe(or justpython, if it is on your PATH variable) - Arguments:
C:\path\to\script.py
UDT automatically adds some LLT_* compatibility variables to the process environment that can be accessed from within the script. They are useful for more advanced scripts, where context is needed. Depending on what was the trigger, different variables are added.
Environment variables
- When AC power adapter is connected
LLT_IS_AC_ADAPTER_CONNECTED=TRUE
- When low wattage AC power adapter is connected
LLT_IS_AC_ADAPTER_CONNECTED=TRUELLT_IS_AC_ADAPTER_LOW_POWER=TRUE
- When AC power adapter is disconnected
LLT_IS_AC_ADAPTER_CONNECTED=FALSE
- When Power Mode is changed:
LLT_POWER_MODE=<value>, wherevalueis one of:1- Quiet,2- Balance,3- Performance,255- CustomLLT_POWER_MODE_NAME=<value>, wherevalueis one of:QUIET,BALANCE,PERFORMANCE,CUSTOM
- When game is running
LLT_IS_GAME_RUNNING=TRUE
- When game closes
LLT_IS_GAME_RUNNING=FALSE
- When app starts
LLT_PROCESSES_STARTED=TRUELLT_PROCESSES=<value>, wherevalueis comma separated list of process names
- When app closes
LLT_PROCESSES_STARTED=FALSELLT_PROCESSES=<value>, wherevalueis comma separated list of process names
- Lid opened
LLT_IS_LID_OPEN=TRUE
- Lid closed
LLT_IS_LID_OPEN=FALSE
- When displays turn on
LLT_IS_DISPLAY_ON=TRUE
- When displays turn off
LLT_IS_DISPLAY_ON=FALSE
- When external display is connected
LLT_IS_EXTERNAL_DISPLAY_CONNECTED=TRUE
- When external display is disconnected
LLT_IS_EXTERNAL_DISPLAY_CONNECTED=FALSE
- When HDR is on
LLT_IS_HDR_ON=TRUE
- When HDR is off
LLT_IS_HDR_ON=FALSE
- When WiFi is connected
LLT_WIFI_CONNECTED=TRUELLT_WIFI_SSID=<value>, wherevalueis the SSID of the network
- When WiFi is disconnected
LLT_WIFI_CONNECTED=FALSE
- At specified time
LLT_IS_SUNSET=<value>, wherevalueisTRUEorFALSE, depending on configuration of the triggerLLT_IS_SUNRISE=<value>, wherevalueisTRUEorFALSE, depending on configuration of the triggerLLT_TIME", wherevalueisHH:mm, depending on configuration of the triggerLLT_DAYS", wherevalueis comma separated list of:MONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY,SUNDAY, depending on configuration of the trigger
- Periodic action
LLT_PERIOD=<value>, wherevalueis the interval in seconds
- On startup
LLT_STARTUP=TRUE
- On resume
LLT_RESUME=TRUE
If "Wait for exit" is checked, UDT will capture the output from standard output of the launched process. This output is stored in $RUN_OUTPUT$ variable and can be displayed in Show notification step.
UDT ships two command-line surfaces with different responsibilities:
udt.exeis the Windows IPC remote control client. It requires the Electron app to be running in the background and the CLI option to be enabled.udt-cli.exeremains as a one-train alias (copy) so old scripts keep working.udtinside*_CLI_cross-platform.zip(dotnet udt.dll/udt/udt.cmd) is the independentUniversalDeviceToolkit.CrossPlatformdiagnostics CLI. It runs without the Electron app and is the Windows/macOS/Linux path for safe platform discovery and diagnostics.
The Windows IPC CLI executable is udt.exe (alias udt-cli.exe) and can be found in the install directory.
For CLI to work properly, UDT needs to run in the background and CLI option needs to be enabled in UDT settings. You can also chose to add udt.exe to your PATH variable for easier access.
Contract, --json, and doctor: Docs/CLI.md. Agent skill (copy into ~/.cursor/skills/udt-hardware-cli/): Docs/skills/udt-hardware-cli/SKILL.md.
CLI does not need to be ran as Administrator.
Features
-
udt doctor- inspect CLI readiness without IPC (--jsonfor agents) -
udt --json …- single JSON object on stdout for scripts and agents -
udt quickAction --list- list all Quick Actions -
udt quickAction <name>- run Quick Action with given<name> -
udt feature --list- list all supported features -
udt feature get <name>- get value of a feature with given<name> -
udt feature set <name> --list- list all values for a feature with given<name> -
udt feature set <name> <value>- set feature with given<name>to a specified<value> -
udt spectrum profile get- get current profile Spectrum RGB is set to -
udt spectrum profile set <profile>- set Spectrum RGB profile to<profile> -
udt spectrum brightness get- get current brightness Spectrum RGB is set to -
udt spectrum brightness set <brightness>- set Spectrum RGB brightness to<brightness> -
udt rgb get- get current 4-zone RGB preset -
udt rgb set <profile>- set 4-zone RGB to<preset>
The plugin system was retired in 6.1. Plugin loading, the Plugin Extensions page, and the plugin catalog tooling have been removed from this repository.
Where former capabilities went:
- Custom Mouse → built-in Cursor & Pointer controls on the Mouse page (existing cursor themes and settings are imported automatically)
- Network Acceleration → built-in since 5.0 under System Optimization → Network & acceleration
- Shell Integration / ViVeTool → delisted; no host built-in replacement
Existing %LOCALAPPDATA%\UniversalDeviceToolkit\plugins data is no longer loaded. The legacy plugin-catalog GitHub release tags are historical archives and must not be used as application update channels. See CHANGELOG for details.
Special thanks to:
- ViRb3, for creating Lenovo Controller, which was used as a base for this tool
- falahati, for creating NvAPIWrapper and WindowsDisplayAPI
- SmokelessCPU, for help with 4-zone RGB and Sprectrum keyboard support
- Mario Bălănică, for all contributions
- Ace-Radom, for all contributions
Translations provided by:
- Bulgarian - Ekscentricitet
- Chinese (Simplified) - 凌卡Karl, Ace-Radom
- Chinese (Traditional) - flandretw
- Czech - J0sef
- Dutch - Melm, JarneStaalPXL
- French - EliotAku, Georges de Massol, Rigbone, ZeroDegree
- German - Sko-Inductor, Running_Dead89
- Greek - GreatApo
- Italian - Lampadina17
- Karakalpak - KarLin, Gulnaz, Niyazbek Tolibaev, Shingis Joldasbaev
- Latvian - RJSkudra
- Romanian - Mario Bălănică
- Slovak - Mitschud, Newbie414
- Spanish - M.A.G.
- Polish - Mariusz Dziemianowicz
- Portugese - dvsilva
- Portuguese (Brasil) - Vernon
- Russian - Edward Johan
- Turkish - Undervolt
- Ukrainian - Vladyslav Prydatko, Dmytro Zozulia
- Vietnamese - Not_Nhan, Kuri, Nagidrop
Many thanks to everyone else, who monitors and corrects translations!
- Why do I get a message that Vantage is still running, even though I uninstalled it?
- Why is my antivirus reporting that the installer contains a virus/trojan/malware?
- Can I customize hotkeys?
- Can I customize Conservation mode threshold?
- Can I customize fans in Quiet, Balance or Performance modes?
- Why can't I switch to Performance or Custom Power Mode on battery?
- Why does switching to Performance mode seem buggy, when AI Engine is enabled?
- Why am I getting incompatible message after motherboard replacement?
- Why isn't a game detected, even though Actions are configured properly?
- Can I use other RGB software while using UDT?
- Will iCue RGB keyboards be supported?
- Can I have more RGB effects?
- Can you add fan control to other models?
- Why don't I see the custom tooltip when I hover the UDT icon in tray?
- How can I OC/UV my CPU?
- What if I overclocked my GPU too much?
- Why is my Boot Logo not applied?
- Why do I see stuttering when using Smart Fn Lock?
- Which generation is my laptop?
Starting from version 2.14.0, UDT is much more strict about detecting leftover processes related to Vantage. Vantage installs 3 components:
- Lenovo Vantage app
- Lenovo Vantage Service
- System Interface Foundation V2 Device
The easiest solution is to go into UDT settings and select options to disable Lenovo Vantage, LegionZone and Hotkeys (only still installed ones are shown).
If you want to remove them instead, make sure that you uninstall all 3, otherwise some options in UDT will not be available. You can check Task Manager for any processes containing Vantage or ImController. You can also check this guide for more info: Uninstalling System Interface Foundation V2 Device, if you have troubles getting rid of ImController processes.
UDT makes use of many low-level Windows APIs that can be falsely flagged by antiviruses as suspicious, resulting in a false-positive. UDT is open source and can easily be audited by anyone who has any doubts as to what this software does. Release payloads and installers are built on GitHub with GitHub Actions, signed through Azure Trusted Signing, and verified before publication. Unsigned local builds should not be treated as official release artifacts.
If you downloaded the installer from this projects website, you shouldn't worry - the warning is a false-positive. That said, if you can help with resolving this issue, let's get in touch.
You can customize Fn+F9 hotkey in UDT settings. Other hotkeys can't be customized.
No. Conservation mode threshold is set in firmware to 60% (2021 and earlier) or 80% (2022 and later) and it can't be changed.
No, it isn't possible to customize how the fan works in power modes other than Custom.
Starting with version 2.11.0, UDT's behavior was aligned with Vantage and Legion Zone and it does not allow using them without an appropriate power source.
If for whatever reason you want to use these modes on battery anyway, you can use --allow-all-power-modes-on-battery argument. Check Arguments section for more details.
Warning
Power limits and other settings are not applied correctly on most devices when laptop is not connected to full power AC adapter and unpredictable and weird behavior is expected. Therefore, no support is provided for issues related to using this argument.*
It seems that some BIOS versions indeed have weird issues when using Fn+Q. Only hope is to wait for Lenovo to fix it.
Sometimes new motherboard does not contain correct model numbers and serial numbers. You should try this tutorial to try and recover them.
Game detection feature is built on top of Windows' game detection, meaning UDT will react to EXE files that Windows considers "a game". That also means that if you nuked Xbox Game Bar from your installation, there is 99.9% chance this feature will not work.
Windows probably doesn't recognize all games properly, but you can mark any program as game in Xbox Game Bar settings (Win+G). You can find list of recognized games in registry: HKEY_CURRENT_USER\System\GameConfigStore\Children.
In general, yes. UDT will disable RGB controls when Vantage is running to avoid conflicts. If you use other RGB software like L5P-Keyboard-RGB or OpenRGB, you can disable RGB in UDT to avoid conflicts with --force-disable-rgbkb or --force-disable-spectrumkb argument. Check Arguments section for more details.
No. Check out OpenRGB project.
Only options natively supported by hardware are available; adding support for custom effects is not planned. If you would like more customization check out L5P-Keyboard-RGB or OpenRGB.
Fan control is available on Gen 7 and later models. Older models will not be supported due to technical limitations.
In Windows 10 and 11, Microsoft did plenty of changes to the tray, breaking a lot of things on the way. As a results custom tooltips not always work properly. Solution? Update your Windows and keep fingers crossed.
There are very good tools like Intel XTU (which is used by Vantage) or ThrottleStop made just for that.
If you end up in a situation where your GPU is not stable and you can't boot into Windows, there are two things you can do:
- Go into BIOS and try to find and option similar to "Enabled GPU Overclocking" and disable it, start Windows, and toggle the BIOS option again to Enabled.
- Start Windows in Safe Mode, and delete
gpu_oc.jsonfile under the compatibility settings directory, which is located in"%LOCALAPPDATA%\UniversalDeviceToolkit.
When you change the Boot Logo, UDT verifies that it is in the format that is correct format and correct resolution. If UDT shows that boot logo is applied, it means that the setting was correctly saved to UEFI. If you don't see the custom boot logo, it means that even though UEFI is configured and custom image is saved to UEFI partition, your UEFI for some reason does not render it. In this case the best idea is to try a different image, maybe in different format, edited with different image editor etc. If the boot logo is not shown after all these steps, it's probably a problem with your BIOS version.
On some BIOS versions, toggling Fn Lock causes a brief stutter and since Smart Fn Lock is basically an automatic toggle for Fn Lock, it is also affected by this issue. Try disabling "Fool proof Fn Lock" (or similar) option in BIOS - it was reported that it fixes stutter when toggling Fn Lock.
In latest version UDT removes this feature for Chinese models due to increasing unreliability. If you got warranty infos before it should be displayed normally, but after manually refreshing or deleting stored datas the infos will disappear. This change only affects users with a Chinese Legion laptop.
Check the model number. Example model numbers are 16ACH6H or 16IAX7. The last number of the model number indicates generation.
Some, less frequently needed, features or options can be enabled by using additional arguments. These arguments can either be passed as parameters or added to args.txt file.
--trace- enables logging to%LOCALAPPDATA%\UniversalDeviceToolkit\logs--minimized- starts UDT minimized to tray--disable-tray-tooltip- disables tray tooltip that is shown when you hover the cursors over tray icon--allow-all-power-modes-on-battery- allows using all Power Modes without AC adapter (No support is provided when this argument is used)--force-disable-rgbkb- disables all lighting features for 4-zone RGB keyboards--force-disable-spectrumkb- disables all lighting features for Spectrum per-key RGB keyboards--force-disable-lenovolighting- disables all lighting features related to panel logo, ports backlight and some white backlit keyboards--experimental-gpu-working-mode- changes GPU Working Mode switch to use experimental method, that is used by LegionZone (No support is provided when this argument is used)--proxy-url=example.com- specifies proxy server URL that UDT should use--proxy-username=some_username- if applicable, specifies proxy server username to use--proxy-password=some_password- if applicable, specifies proxy server password to use--proxy-allow-all-certs- if needed relaxes criteria needed to establish HTTPS/SSL connections via proxy server--disable-update-checker- disable update checks in UDT, in case you want to rely on winget, scoop etc.
If you decide to use the arguments with args.txt file:
- Go to
%LOCALAPPDATA%\UniversalDeviceToolkit - Create or edit
args.txtfile in there - Paste one argument per line
- Start UDT
Arguments not listed above are no longer needed or available.
In all troubleshooting situations, logs provide important information. Always attach logs to your issues. Critical error logs are saved automatically and saved under "%LOCALAPPDATA%\UniversalDeviceToolkit\logs".
To collect logs:
- Make sure that Universal Device Toolkit is not running (also gone from tray area).
- Open
Run(Win+R) and start the app with--trace. During the rename, the compatibility path may still be"%LOCALAPPDATA%\Programs\UniversalDeviceToolkit\Lenovo Legion Toolkit.exe" --trace. - UDT will start and in the title bar you should see:
[LOGGING ENABLED] - Reproduce the issue you have (i.e. try to use the option that causes issues)
- Close UDT (also make sure it's gone from tray area)
- Again, in
Run(Win+R) type"%LOCALAPPDATA%\UniversalDeviceToolkit\logs" - You should see at least one file. Theses are the logs you should attach to the issue.
I appreciate any feedback that you have, so please do not hesitate to report issues. Pull Requests are also welcome, but make sure to check out CONTRIBUTING.md first!
Important
Hardware-control requests are limited to Lenovo Legion, IdeaPad Gaming, and LOQ series — please do not open issues asking for full Vantage-style control on other brands or unsupported Lenovo lines.
Hardware-provider contributions are welcome: Non-Lenovo and unsupported Lenovo PCs run in basic mode until a tested provider exists. Device-pack data, logs, and hardware testing for a real provider are appreciated; generic Windows-utility feature requests are not.
It would be great to expand the list of compatible devices, but to do it your help is needed!
If you are willing to check if this app works correctly on your device that is currently unsupported, click Continue on the popup you saw on startup. Universal Device Toolkit will start logging automatically so you can submit them if anything goes wrong.
Remember that some functions may not function properly.
I would appreciate it, if you create an issue here on GitHub with the results of your testing.
Make sure to include the following information in your issue:
- Full model name (i.e. Legion 5 Pro 16ACH6H)
- List of features that are working as expected.
- List of features that seem to not work.
- List of features that crash the app.
The more info you add, the better the app will get over time. If anything seems off, write down precisely what was wrong and attach logs (%LOCALAPPDATA%\UniversalDeviceToolkit\log).
UDT localization is managed through Crowdin with a repository-level config at crowdin.yml.
- Source files: neutral
Resource.resxin four modules:UniversalDeviceToolkit.Lib/ResourcesUniversalDeviceToolkit.Lib.Automation/ResourcesUniversalDeviceToolkit.Lib.Macro/ResourcesUniversalDeviceToolkit.CLI/Resources(CLI.Resources.resx) The Electron UI strings live inUniversalDeviceToolkit.Electron/src/renderer/src/i18n/locales/(TS modules).
- Target files:
Resource.<locale>.resx(orCLI.Resources.<locale>.resxfor CLI) beside each source file. Culture names use the BCP 47 canonical form (zh-Hans,zh-Hant,pt-BR,nl-NL,uz-Latn-UZ) — enforced byScripts/Assert-CultureNaming.ps1. - Locale mapping is defined in
crowdin.yml(for examplezh-CN -> zh-Hans,zh-TW -> zh-Hant,pt-BR -> pt-BR).
Typical CLI commands:
# upload source strings
crowdin upload sources --config crowdin.yml
# upload existing translations
crowdin upload translations --config crowdin.yml
# download translated files
crowdin download --config crowdin.ymlAdditional documentation is indexed in Docs/README.md. Topic docs in Docs/:
| Document | Description |
|---|---|
| ARCHITECTURE.md | System architecture, components, and data flow |
| DEPLOYMENT.md | Build, test, deployment, and release procedures |
| LanguagePacks.md | Online language pack catalog protocol and lifecycle |
| NetworkAcceleration.md | Built-in network & acceleration module |
| PROMOTION_EN.md | Release and social promotion copy (English) |
| PROMOTION_CN.md | Release and social promotion copy (Chinese) |
| COMMUNITY_OUTREACH.md | Community posting playbook and submission tracker |
| SECURITY.md | Security policy and best practices |
| CODE_OF_CONDUCT.md | Community guidelines and contribution standards |
Captured at 1300×850 logical window size (pixel dimensions follow Windows display scale). README images are displayed at 700 px width.
| File | Description |
|---|---|
Assets/UDT_Promo_en.mp4 |
30-second English trailer (click the poster in the Trailer section) |
Assets/UDT_Promo_zh.mp4 |
30-second Chinese trailer (used by README_zh-hans.md) |
Assets/UDT_Promo.mp4 |
Same file as UDT_Promo_en.mp4 (legacy path) |
Assets/UDT_Promo_poster.jpg |
Trailer poster |
Assets/Screenshot_main.png |
Main application interface (English, Dark theme) |
Assets/Screenshot_zh-hans.png |
Chinese localization interface (Dark theme) |
Refresh procedure (keep 1300×850 logical size): see DEPLOYMENT.md. Brand binaries are unified under repo-root Assets/.
- Application won't start? Check .NET 10.0 installation
- Features not working? See compatibility section
- Logs needed? Follow log collection guide
- Still need help? Open a GitHub Issue
Universal Device Toolkit is distributed under the GNU GPL v3.0. See LICENSE.
This project is a modified continuation derived from Lenovo Legion Toolkit, originally created by Bartosz Cichecki. Original author attribution and copyright information are preserved in NOTICE; Universal Device Toolkit changes are maintained by Universal Device Toolkit contributors.
GitHub ranks repos by stars. One click is how the next Legion owner finds a Vantage-free toolkit. Target: 1,000 stars.
Contributors welcome! Check out CONTRIBUTING.md to get started.



