Следите за новостями GitVerse в нашем телеграм-канале

LenovoLegionToolkit

Форк
0

README.md
Logo

Lenovo Legion Toolkit

Build Crowdin Join Discord


Other language versions of this README file:


Ukrainian Flag

Support the Armed Forces of Ukraine and People Affected by Russia’s Aggression on UNITED24, the official fundraising platform of Ukraine: https://u24.gov.ua.

Слава Україні!

Ukrainian Flag


Lenovo Legion Toolkit (LLT) is a utility created for Lenovo Legion (and similar) series laptops, that allows changing a couple of features that are only available in Lenovo Vantage or Legion Zone.

It runs no background services, uses less memory, uses virtually no CPU, and contains no telemetry. Just like Lenovo Vantage, this application is Windows only.

 

Join the Legion Series Discord: https://discord.com/invite/legionseries!

If you are looking for a Vantage alternative that was made for Linux, check LenovoLegionLinux project.

 

Click here for more screenshots...
KeyboardBattery
ActionsDownloads
Custom ModeCustom Mode

Table of Contents

Disclaimer

The tool comes with no warranty. Use at your own risk.

Please be patient and read through this readme carefully - it contains important information.

Download

You can download the program by the following ways:

  • Manually from the Releases page

  • Using winget:

    winget install BartoszCichecki.LenovoLegionToolkit
  • Using Scoop:

    scoop bucket add versions
    scoop bucket add extras
    scoop install extras/lenovolegiontoolkit

Next steps

LLT 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 LLT will always run on startup and will take over all functions that were handled by Vantage and Hotkeys.

If you close LLT completely some functions will not work, like synchronizing power plans with current Power Mode or Actions. This is due to the fact that LLT does not run any background services and won't be able to respond to changes.

Required drivers

If you installed LLT on a clean Windows install, make sure to have necessary drivers installed. If drivers are missing, some options might not be available. Especially make sure that these two are installed on your system:

  1. Lenovo Energy Management
  2. Lenovo Vantage Gaming Feature Driver

Problems with .NET?

If for whatever reason LLT installer did not setup .NET properly:

  1. Go to https://dotnet.microsoft.com/en-us/download/dotnet/6.0
  2. Find section ".NET Desktop Runtime"
  3. Download x64 Windows installer
  4. Run the installer

Note: If you installed LLT from Scoop, .NET 6 should have been installed automatically as a dependency. If anything fails, use

scoop update
to update all packages and try to reinstall LLT with
--force
argument.

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 something like:

Microsoft.NETCore.App 6.0.15 [C:\Program Files\dotnet\shared\Microsoft.NETCore.App]

and

Microsoft.WindowsDesktop.App 6.0.15 [C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App]

The exact version number can be different, but as long as it is

6.x.x
it should be fine. If after these steps LLT still shows an error on startup that .NET couldn't be found or similar, the problem is on your machine and not with LLT.

Want to help with testing?

Join the Legion Series Discord and head to

#legion-toolkit
channel. Beta versions of future releases are posted there frequently!

Compatibility

Lenovo Legion Toolkit is made for Lenovo Legion laptops, and other similar laptops like Ideapad Gaming, LOQ and their Chinese variants.

Generations 6 (MY2021), 7 (MY2022) and 8 (MY2023) are supported, although some features also work on the 5th generation (MY2020). Issues related to devices older than Gen 6 or that are not Legions are out of scope of this project.

If you are getting an incompatible message on startup, you can check the Contribution section down at the bottom, to see how can you help. Keep in mind, that not always I can make all options compatible with all hardware since I do not have access to it.

Support for other laptops is not planned.

Lenovo's software

Overall the recommendation is to disable or uninstall Vantage, Hotkeys and Legion Zone while using LLT. There are some functions that cause conflicts or may not work properly when LLT is working along side other Lenovo apps.

Other remarks

LLT 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 - LLT needs an account with Administrator rights. If you install LLT on an account without such rights, LLT will not work properly.

Features

The app allows to:

  • Change settings like power mode, battery charging mode, etc. that are available only through Vantage.
  • Spectrum RGB, 4-zone RGB and White backlight keyboards support.
  • Deactivate discrete GPU (NVIDIA only).
  • View battery statistics.
  • Check for driver and software updates.
  • Check warranty status.
  • Define Actions that will run when the laptop is i.e. connected to AC power.
  • Disable/enable Lenovo Vantage, Legion Zone and Lenovo Hotkeys service without uninstalling them.
  • ... and more!

Custom Mode

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.

RGB and lighting

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 LLT, 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 LLT.

Hybrid Mode and GPU Working Modes

There are two main way you can use your dGPU:

  1. 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
  2. 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:

  1. 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
  2. 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 LLT, 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. LLT 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.

These options are not Advanced Optimus and work separately from it.

Deactivate discrete NVIDIA GPU

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:

  1. killing all processes running on dGPU (this one seems to work better),
  2. 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.

Keep in mind that some apps may not like this feature and crash when you deactivate dGPU.

Overclock discrete NVIDIA GPUs

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.

Windows Power Plans

Lenovo Legion Toolkit will automatically switch Windows power plans when Power Mode changes and when Lenovo Vantage is disabled.

On some laptops though, Lenovo Vantage never switched power plans. If you have one of the laptops where Lenovo Vantage does not change Windows power plans automatically you can override this behavior in Settings. This will allow Toolkit to always change Windows power plans, even if Lenovo Vantage is running in the background.

Laptops that have S0 Low Power mode enabled, also known as Modern Standby, do not work well with mutliple power plans, especially with performance power plans.

On Gen 6 and 7 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, LLT 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.

Donate

If you enjoy using the Lenovo Legion Toolkit, consider donating.

Donate with PayPal

PayPal QR code

Credits

Special thanks to:

Translations provided by:

Many thanks to everyone else, who monitors and corrects translations!

FAQ

Uninstalling System Interface Foundation V2 Device, if you have troubles getting rid of

ImController
processes.

Arguments section for more details.

Note that 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.

this tutorial to try and recover them. If that method does not succeed, you can workaround it with

--skip-compat-check
argument. Check Arguments section for more details.

L5P-Keyboard-RGB or OpenRGB, you can disable RGB in LLT to avoid conflicts with

--force-disable-rgbkb
or
--force-disable-spectrumkb
argument. Check Arguments section for more details.

OpenRGB project.

L5P-Keyboard-RGB or OpenRGB.

Intel XTU (which is used by Vantage) or ThrottleStop made just for that.

CONTRIBUTING.md first!

Translation

Crowdin has been selected as the tool for handling translations. If you want to contribute, go to https://crowdin.com/project/llt and request access.

Bugs

If you find any bugs in the app, please report them. Always attach logs to your issues. You can find logs in

%LOCALAPPDATA%\LenovoLegionToolkit\log
.

Compatibility

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. Lenovo Legion Toolkit will start logging automatically so you can submit them if anything goes wrong.

If your laptop is not part of Legion, IdeaPad Gaming or LOQ series, this software is not for you. Please do NOT open compatibility requests for other devices.

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:

  1. Full model name (i.e. Legion 5 Pro 16ACH6H)
  2. List of features that are working as expected.
  3. List of features that seem to not work.
  4. 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%\LenovoLegionToolkit\log
).

Thanks in advance!

Описание

Lightweight Lenovo Vantage and Hotkeys replacement for Lenovo Legion laptops.

Языки

C#

  • Inno Setup
  • Batchfile
Сообщить о нарушении

Использование cookies

Мы используем файлы cookie в соответствии с Политикой конфиденциальности и Политикой использования cookies.

Нажимая кнопку «Принимаю», Вы даете АО «СберТех» согласие на обработку Ваших персональных данных в целях совершенствования нашего веб-сайта и Сервиса GitVerse, а также повышения удобства их использования.

Запретить использование cookies Вы можете самостоятельно в настройках Вашего браузера.