battery-status-led/README.md

# Battery Status LED
Battery (low/critical) status indication by making a (the capslock) LED blink

## Prerequisites:
Make sure you have your laptop's ACPI module compiled into your kernel:
```
Device Drivers > X86 Platform Specific Device Drivers
```

For example: Asus laptop extras, ThinkPad ACPI Laptop Extras, etc.

## Usage:
Execute the script as a root user:
```
/usr/bin/battery-status-led.sh
```

Or start with systemd:
```
systemctl start battery-status-led
systemctl enable battery-status-led
```

The LED device can be changed by editing the systemd service file's line:
```
Environment="BATTERY_STATUS_LED_DEV=/sys/class/leds/input4\:\:capslock"
```

## Manual install on gentoo:
```
cd DIR
git clone https://github.com/dmatetelki/battery-status-led
cd /usr/local/portage/app-misc/
ln -s DIR/battery-status-led/app-misc/battery-status-led  battery-status-led
ebuild battery-status-led-0.1.ebuild digest
emerge battery-status-led
```

## Creating a debian package and installing it:
```
cd DIR
git clone https://github.com/dmatetelki/battery-status-led
cd battery-status-led/debian
./package.deb
sudo dpkg -i ./batterystatusled_0.1-1.deb
```

## Creating RPM package and installing it:
```
cd DIR
git clone https://github.com/dmatetelki/battery-status-led
cd battery-status-led/redhat
./package.rpm
sudo rpm -i ./battery-status-led-0.1-1.noarch.rpm
```

## Note:
Did you know that the CapsLock key can be turned into another Ctrl?
Add the following lines to `~/.Xmodmap` :
```
remove Lock = Caps_Lock
keycode 0x42 = Control_L
add Control = Control_L
```