Set your keyboard LEDs from the Mac OS X command-line
Failed to load latest commit information.
Source Adjust project to always use latest mac SDK Dec 24, 2016
.gitignore Initial commit Feb 11, 2015
LICENSE Initial commit Feb 11, 2015 Update Feb 16, 2015

SetLEDs for Mac OS X

This command-line tool lets you set your keyboard LEDs. This is especially useful if you have a back-lit keyboard and don't want scroll lock, number lock or caps lock to remain unlit.


Setting the LED on or off does not affect the behavior of that key so even though the led for caps lock will be on caps lock itself will still be off. Tapping the key will cause the lock to come on but the LED will already be on so it will not appear to change. Tapping it again will turn it off (and cause the LED to turn off).


You can set LEDs by simply specifing either a - to turn an LED off or a + to turn an LED on followed by either the word scroll (for scroll lock), num (for numeric lock) or caps (for caps lock). e.g.

setleds -caps +scroll

Name matching

By default setledsmac will set the modifiers for all keyboards attached to your Mac. If you wish to limit it you can use the -name parameter followed by a wildcard. Note that if you want to use a space then specify the wildcard in quotes, e.g.

setleds +scroll -name "Apple Key*"

Verbose mode

setledsmac will report what keys it changed for each keyboard. This is sometimes different per keyboard if either the keyboard does not have that modifier (e.g. Apple keyboards do not have scroll lock) or if the keyboard already had that LED on.

Specifying -v on the command line will cause setledsmac to report the state of the other unchanged modifier keys on that keyboard too. Note that you will not see the state of modifiers that keyboard does not have.