✨📝 Power + docs

POWER.md

@@ -0,0 +1,39 @@
+# ThinkPad Power Management Guide
+
+## Battery Status Commands
+```bash
+# Detailed battery information
+upower -i /org/freedesktop/UPower/devices/battery_BAT0
+
+# TLP battery status and thresholds
+sudo tlp-stat -b
+
+# ACPI information (temperature, cooling)
+acpi -V
+```
+
+## Battery Charge Control
+```bash
+# Set full charge mode (useful before travel)
+sudo tlp setcharge 5 100 BAT0
+
+# Return to battery-preserving thresholds
+sudo tlp setcharge 60 80 BAT0
+```
+
+These commands are temporary. After reboot, your NixOS configuration thresholds (60-80) will be restored.
+
+## TLP Configuration Explained
+
+Our configuration (`services.tlp.settings`) manages several power aspects:
+
+1. **Battery Thresholds** (60-80%): Extends battery lifespan by preventing full charges and deep discharges
+2. **CPU Management**: Performance on AC, power saving on battery
+3. **Disk & PCIe**: Balanced power/performance settings
+4. **WiFi & USB**: Power saving features with longer timeouts on AC
+5. **USB Device Exceptions**: Prevents power management for specific USB devices (keyboard, mouse) to ensure responsiveness
+
+## Power Alerts (UPower)
+- Low Battery: 15%
+- Critical: 10%
+- Emergency Action (Hibernate): 5%

README.md

@@ -35,6 +35,7 @@ This repository contains a NixOS system configuration using the Flakes feature.
   - Git configuration
   - Custom terminal setup (Kitty)
 - **Gaming Support** with Steam and Prismlauncher
+- [**Power management**](POWER.md)
 - **Custom Scripts** for:
   - Power management
   - Window management

configuration/nixos/optional/power-management.nix

@@ -1,4 +1,4 @@
-{...}: {
+{pkgs, ...}: {
   services.tlp = {
     enable = true;
     settings = {
@@ -51,4 +51,9 @@
   # Power consumption analysis + auto-tuning on startup
   powerManagement.powertop.enable = true;
   services.acpid.enable = true;
+
+  environment.systemPackages = with pkgs; [
+    powertop
+    acpi
+  ];
 }

modules/home-manager/wayland/waybar/default.nix

@@ -64,15 +64,15 @@ in {
               "clock"
             ];
             modules-right =
-              [
+              optional cfg.battery "battery"
+              ++ [
                 "group/info"
                 "wireplumber"
                 "network"
                 "group/tray"
                 "systemd-failed-units"
               ]
-              ++ optional powerMenu.enable "custom/power"
-              ++ optional cfg.battery "battery";
+              ++ optional powerMenu.enable "custom/power";
 
             "group/tray" = {
               orientation = "horizontal";
@@ -196,11 +196,11 @@ in {
 
             battery = mkIf cfg.battery {
               format = "{icon} {capacity}%";
-              format-icons = ["" "" "" "" ""];
-              format-charging = "⚡ {capacity}%";
+              format-icons = ["󰂃" "󰁺" "󰁾" "󰂁" "󰁹"];
+              format-charging = "󰂄 {capacity}%";
               interval = 30;
               states = {
-                warning = 30;
+                warning = 25;
                 critical = 15;
               };
             };