🚀 Lenovo Vantage for Linux (Enhanced)

A modern, feature-rich Linux alternative to Lenovo Vantage with advanced system monitoring, power management, and enhanced user experience.

✨ Features

🔋 Hardware Controls

Core Lenovo Features:

• Conservation Mode - Limit battery charge to 60% to prolong battery life
• Always-On USB - Keep USB ports powered during sleep/hibernate
• Thermal/Fan Control - Multiple fan modes (Silent, Standard, Performance, Dust Cleaning)
• FN Key Lock - Toggle function key behavior
• Camera Privacy - Enable/disable camera at hardware level
• Microphone Control - Mute/unmute microphone
• Touchpad Control - Enable/disable touchpad
• WiFi Control - Quick WiFi on/off toggle

⚡ Advanced Power Management

• Smart Power Profiles - Power Saver, Balanced, Performance, Gaming, Silent modes
• Automatic Profile Switching - Auto-switch based on power source (AC/Battery)
• CPU Governor Control - Automatic CPU frequency scaling
• Display Brightness Management - Profile-based brightness adjustment
• Advanced Power Saving - USB autosuspend, disk APM levels

📊 Real-time System Monitoring

• Live System Stats - CPU temperature, battery status, memory usage
• Intelligent Alerts - Battery low warnings, temperature monitoring
• Background Monitoring - Continuous system health monitoring
• System Reports - Comprehensive hardware and software reports

🔧 Enhanced User Experience

• Modern GUI - Improved Zenity-based interface with better layouts
• Configuration System - Persistent settings and preferences
• Advanced Logging - Multi-level logging with rotation
• Desktop Notifications - Rich notifications with sound support
• Theming Support - Multiple UI themes
• Multi-language Ready - Prepared for internationalization

🛡️ Reliability & Safety

• Error Handling - Comprehensive error checking and recovery
• Hardware Detection - Automatic compatibility checking
• Dependency Management - Smart dependency verification
• Safe Operations - All hardware changes use proper elevation

📦 Installation

Quick Install

git clone https://github.com/niizam/vantage.git
cd vantage
sudo make install

Manual Installation

# Clone the repository
git clone https://github.com/niizam/vantage.git
cd vantage

# Install dependencies (see requirements below)
chmod +x install.sh
sudo ./install.sh

# Install Vantage (Enhanced version is default)
sudo make install

Running Vantage

• From Applications Menu: Search for "Lenovo Vantage" in your applications
• From Terminal: Run vantage command
• From File Manager: Execute the script directly

🔧 Requirements

Essential Dependencies

• zenity - GUI dialogs and interface
• xinput - Input device control
• pactl (PulseAudio/PipeWire) - Audio control

Optional Dependencies

• nmcli (NetworkManager) - WiFi control
• notify-send (libnotify) - Desktop notifications
• powerprofilesctl - Advanced power profile management
• hdparm - Hard drive power management
• dmidecode - Hardware information

Installation by Distribution

Arch Linux / Manjaro:

sudo pacman -S zenity xorg-xinput networkmanager pulseaudio libnotify power-profiles-daemon hdparm dmidecode

Ubuntu / Debian / Pop!_OS / Linux Mint:

sudo apt install zenity xinput network-manager pulseaudio-utils libnotify-bin power-profiles-daemon hdparm dmidecode

Fedora / RHEL / CentOS:

sudo dnf install zenity xinput NetworkManager pulseaudio-utils libnotify power-profiles-daemon hdparm dmidecode

openSUSE:

sudo zypper install zenity xinput NetworkManager pulseaudio-utils libnotify-tools power-profiles-daemon hdparm dmidecode

🎯 Usage

Basic Operations

1. Launch Vantage from your applications menu
2. Select the feature you want to control
3. Choose the desired setting
4. Confirm changes when prompted

Power Profile Management

• Access via "Power Profiles" in the main menu
• Profiles automatically adjust CPU, brightness, and power settings
• Enable auto-switching in settings for seamless operation

System Monitoring

• Start monitoring from "System Monitor" menu
• View real-time system information
• Generate detailed system reports
• Configure monitoring alerts in settings

Configuration

• Access settings through the main menu (when advanced options are enabled)
• Modify /home/$USER/.config/vantage/vantage.conf directly
• Enable advanced features and customize behavior

⚙️ Configuration

Configuration File Location

• User config: ~/.config/vantage/vantage.conf
• Logs: ~/.local/share/vantage/logs/vantage.log
• Reports: ~/.local/share/vantage/

Key Configuration Options

# Power management
AUTO_APPLY_POWER_PROFILE="1"
PREFERRED_POWER_PROFILE="balanced"

# Monitoring
AUTO_START_MONITORING="0"
BATTERY_WARNING_LEVEL="20"
TEMPERATURE_WARNING_LEVEL="80"

# UI preferences
ENABLE_NOTIFICATIONS="1"
NOTIFICATION_SOUND="1"
THEME="default"
WINDOW_WIDTH="400"
WINDOW_HEIGHT="500"

# Logging
LOG_LEVEL="INFO"

🔧 Troubleshooting

Common Issues

Vantage won't start:

# Check dependencies
vantage --check-deps

# Check logs
tail -f ~/.local/share/vantage/logs/vantage.log

# Reset configuration
rm -rf ~/.config/vantage/

Features not working:

• Ensure you have a supported Lenovo laptop
• Check if VPC interface exists: ls /sys/bus/platform/devices/VPC2004:*
• Verify permissions and try running with sudo once

Performance issues:

• Disable system monitoring if not needed
• Reduce log level to ERROR in configuration
• Check for conflicting power management tools

Hardware Compatibility

• Primary Support: Lenovo ThinkPad and IdeaPad series with VPC2004 interface
• Limited Support: Other Lenovo laptops (some features may not work)
• Basic Support: Non-Lenovo systems (power profiles and monitoring only)

🤝 Contributing

We welcome contributions! Here's how you can help:

1. Report Issues: Use GitHub issues for bug reports
2. Feature Requests: Suggest new features or improvements
3. Code Contributions: Fork, develop, and submit pull requests
4. Documentation: Help improve documentation and translations
5. Testing: Test on different hardware and distributions

Development Setup

git clone https://github.com/niizam/vantage.git
cd vantage

# Make your changes
# Test thoroughly
# Submit pull request

📜 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

👏 Acknowledgments

• Original Authors: Nizam, Lanchon
• Enhanced by: AI Assistant (2025)
• Community: All contributors and testers

🔗 Links

• Original Repository: github.com/niizam/vantage
• Issues: Report bugs and request features
• Lenovo Support: Lenovo Official Support

🗓️ Changelog

Version 2.0.0 (2025-01-01)

• ✨ Complete rewrite with modular architecture
• ⚡ Advanced power management with 5 profiles
• 📊 Real-time system monitoring and alerts
• 🔧 Comprehensive configuration system
• 📱 Enhanced notifications and logging
• 🎨 Improved user interface
• 🛡️ Better error handling and safety checks
• 📚 Extensive documentation and examples

Version 1.x

• 🔋 Basic Lenovo hardware controls
• 🖥️ Simple Zenity GUI
• ⚙️ Core functionality implementation

---