Skip to main content

KVantage Documentation

Take control of your Lenovo laptop on Linux with a sleek, minimal desktop application. Manage performance profiles, battery conservation, rapid charging, and more—all with an elegant Material UI design.

Get Started in Minutes

Follow these steps to install and run KVantage on your Lenovo laptop.

1

Download the latest release

Download the latest JAR file from the GitHub releases page or use the direct link for the latest version.
wget https://github.com/kosail/KVantage/releases/download/Release_v2.1.0/com.korealm.kvantage-linux-x64-2.1.0-release.jar
2

Ensure Java Runtime is installed

KVantage requires Java to run. Install the Java Runtime Environment if you haven’t already.
# Debian/Ubuntu
sudo apt install default-jre

# Fedora
sudo dnf install java-latest-openjdk

# Arch Linux
sudo pacman -S jre-openjdk
3

Launch KVantage

Run the application with Java. The embedded installer will guide you through setup on first launch.
java -jar com.korealm.kvantage-linux-x64-2.1.0-release.jar
KVantage requires root access to interact with ACPI interfaces, but the GUI itself should never be started as root. The application manages privilege escalation internally and securely through the backend daemon.

Explore by Topic

Learn about the core features and architecture of KVantage.

Performance Profiles

Switch between Power Saving, Intelligent Cooling, and Extreme Performance modes to optimize your laptop’s behavior.

Battery Conservation

Limit battery charge to 80% to extend battery lifespan and health over time.

Rapid Charge

Enable or disable rapid charging to balance charging speed with battery health.

Themes

Choose from multiple beautiful dark and light themes including Whispering Sea, Material, Kanagawa, and Dracula.

Architecture Overview

Understand how KVantage’s frontend and backend work together to control your laptop.

Troubleshooting

Resolve common issues with ACPI interfaces, permissions, and compatibility.

Key Features

Performance Management

Toggle between power saving, extreme performance, and intelligent cooling profiles.

🔋

Battery Health

Protect your battery with conservation mode and monitor remaining battery life.

🎨

Beautiful Themes

Choose from multiple carefully crafted dark and light themes with Material UI aesthetics.

🌍

Multi-Language Support

Available in 8 languages with automatic locale detection based on your system settings.

Ready to take control of your Lenovo laptop?

Get started with KVantage in minutes and experience a cleaner, more powerful way to manage your laptop on Linux.

Install Now

Build docs developers (and LLMs) love