A sleek, modern hardware configuration and monitoring tool built specifically for Pop!_OS and Linux gaming laptops.
Features • Compatibility • Installation • Build from Source • Contributing
Popage is an Electron + React application designed to replace multiple disparate terminal commands and GNOME extensions with a single, beautiful dashboard. It offers real-time monitoring and deeply integrated system controls:
- Comprehensive Hardware Metrics: Monitor CPU, GPU, VRAM, and System RAM usage, clocks, and temperatures.
- Detailed Power Consumption: Uses Intel RAPL to read hardware-level package, core, and iGPU wattage, alongside dGPU and battery discharge rates.
- GPU Process List: Instantly view which processes are running on your discrete GPU (with scrollable list and memory usage).
- Battery Health: View exact battery capacity, cycles, voltage, and current status.
- Graphics Modes: Easily switch between Hybrid, Integrated, Compute, and NVIDIA modes via
system76-power. - Power Profiles: Toggle between Battery Life, Balanced, and Performance modes.
- NVIDIA PowerMizer: Fine-tune your GPU performance level (Auto, Max Performance, Adaptive).
- Battery Conservation: Enable/disable Lenovo Vantage-style conservation mode directly from Linux to keep your battery at ~80% and extend lifespan.
Popage was built primarily for modern Linux systems running proprietary hardware controllers, specifically targeting System76 tools and Lenovo laptops.
Tested Exclusively On:
- Lenovo LOQ 15IAX9E (Intel Core i7-12650HX + NVIDIA RTX 4050)
- OS: Pop!_OS 22.04 LTS (GNOME)
⚠️ Note: While standard monitoring (like RAM and CPU usage) will work on most Linux distros, specific control features (like advanced graphics switching, Battery Conservation, and RAPL energy readings) rely on Lenovo-specific ACPI modules (ideapad_laptop), Intel RAPL interfaces, NVIDIA proprietary drivers, andsystem76-power.
Releases are distributed as standalone AppImage files.
- Go to the Releases tab and download the latest
.AppImage. - Make the file executable:
chmod +x Popage-*.AppImage - Run the application:
./Popage-*.AppImage
By default, standard Linux users do not have permission to read Intel RAPL energy counters. To see CPU Package/Core watts in Popage, you need to add a udev rule:
echo 'SUBSYSTEM=="powercap", ACTION=="add", RUN+="/bin/chmod a+r /sys/class/powercap/intel-rapl:0/energy_uj /sys/class/powercap/intel-rapl:0:0/energy_uj /sys/class/powercap/intel-rapl:0:1/energy_uj"' | sudo tee /etc/udev/rules.d/99-rapl-permissions.rules
# Apply immediately without rebooting
sudo chmod a+r /sys/class/powercap/intel-rapl:0/energy_uj /sys/class/powercap/intel-rapl:0:0/energy_uj /sys/class/powercap/intel-rapl:0:1/energy_ujTo build Popage yourself, you need Node.js installed.
-
Clone the repository:
git clone https://github.com/Junior37534/popage.git cd popage -
Install dependencies:
npm install
-
Run in Development Mode:
npm run dev
-
Build the executable (AppImage for Linux):
npm run build:linux
The generated
.AppImagewill be placed in thedist/directory.
This project was built with heavy assistance from Agentic AI models (such as Claude/Gemini through IDE integrations). The AI was responsible for structuring the Electron/React bridge, designing the UI paradigms, writing bash interaction handlers, and extracting low-level Linux metrics.
While the code has been tested to work seamlessly on the target machine, minor bugs or edge-cases on different hardware configurations might exist.
Found a bug? Have a suggestion? Want to add support for ASUS/Dell/HP specific ACPI calls? Contributions are more than welcome!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Feel free to open an Issue if you experience a crash or missing features on your specific hardware.
Distributed under the MIT License. See LICENSE for more information.