{"id":19,"date":"2011-04-21T09:00:00","date_gmt":"2011-04-21T09:00:00","guid":{"rendered":"http:\/\/mattdturner.com\/wordpress\/?p=19"},"modified":"2013-11-04T10:56:54","modified_gmt":"2013-11-04T17:56:54","slug":"mac-bluetooth-keyboardmouse-battery-level-in-terminal","status":"publish","type":"post","link":"http:\/\/mattdturner.com\/wordpress\/2011\/04\/mac-bluetooth-keyboardmouse-battery-level-in-terminal\/","title":{"rendered":"Mac Bluetooth Keyboard\/Mouse Battery Level in Terminal"},"content":{"rendered":"

There are a few reasons why somebody might want to check the current battery percentage of a bluetooth mouse and\/or keyboard within Terminal on a mac. \u00a0Some that come to mind are for use in GeekTool<\/a>, if you are connected to the computer remotely through ssh, etc.<\/p>\n

Well as it turns out, its actually very easy to do. \u00a0The tool that we will use to check the battery percentage is called “ioreg”. \u00a0The Mac OS X manual describes ioreg as a tool that “displays the I\/O Kit registry. It shows the\u00a0hierarchical\u00a0registry structure as an inverted tree.”<\/p>\n

There are many options available with the ioreg tool, however this article will just be discussing how to check the battery percentage of different devices. \u00a0See the below text for the code to view the battery percentage:<\/p>\n

ioreg -n "IOAppleBluetoothHIDDriver" | grep -i "batterypercent" | sed 's\/[^[:digit:]]\/\/g'\r\n49\r\nioreg -n "BNBMouseDevice" | grep -i "batterypercent" | sed 's\/[^[:digit:]]\/\/g'\r\n45\r\nioreg -n "BNBMouseDevice" | grep -i "batterypercent"\r\n    | |   |     | | |   |   "BatteryPercent" = 45\r\n<\/pre>\n
<\/p>\n
There are a few things that should be noted about the above commands.<\/p>\n
    \n
  1. The -n<\/code> option is used to show the object properties ONLY for the corresponding object name.<\/li>\n
  2. The grep<\/code> command is used to only show lines that contains the term “batterypercent”.\n
      \n
    1. The -i<\/code> in the grep command is used to ignore case in “batterypercent”.<\/li>\n<\/ol>\n<\/li>\n
    2. The sed<\/code> command is used to parse the output text so that it only shows the actual number percentage.<\/li>\n<\/ol>\n
      If, for some reason, your device names are different then you just need to type ioreg -l<\/code> to get an output of all objects. \u00a0Now you can use the Find utility in terminal to search for “batterypercent”. \u00a0There should be very few instances of the string. \u00a0A few lines above the “batterypercent” property, you should see another property that is called “product”. \u00a0This property tells you which device you are looking at. \u00a0Once you know which device it is, you can continue to browse the lines above until you see a line that starts with\u00a0+-o. \u00a0This is the object name. \u00a0See the example below:<\/div>\n
      \n
      \r\n    | |   |     | | | +-o BNBMouseDevice\r\n    | |   |     | | |   | {\r\n    | |   |     | | |   |   "PrimaryUsagePage" = 1\r\n    | |   |     | | |   |   "MaxInputReportSize" = 6\r\n    | |   |     | | |   |   "IOUserClientClass" = "IOHIDLibUserClient"\r\n    | |   |     | | |   |   "BatteryPanic" = No\r\n    | |   |     | | |   |   "VendorID" = 1452\r\n    | |   |     | | |   |   "VersionNumber" = 132\r\n    | |   |     | | |   |   "DeviceAddress" = "34-15-9e-d0-27-aa"\r\n    | |   |     | | |   |   "HIDPointerResolution" = 104595456\r\n    | |   |     | | |   |   "HIDDescriptor" = ((34,<05010902a10185100509190129021500250195027501810$\r\n    | |   |     | | |   |   "SuspendSupported" = Yes\r\n    | |   |     | | |   |   "ExtendedFeatures" = {"SuperMode"={"size"=1,"id"=215,"min"=0,"max"=1,"t$\r\n    | |   |     | | |   |   "MaxFeatureReportSize" = 65\r\n    | |   |     | | |   |   "Product" = "Magic Mouse"\r\n    | |   |     | | |   |   "SerialNumber" = "34-15-9e-d0-27-aa"\r\n    | |   |     | | |   |   "PSM" = 17\r\n    | |   |     | | |   |   "BatteryLow" = No\r\n    | |   |     | | |   |   "Transport" = "Bluetooth"\r\n    | |   |     | | |   |   "Elements" = ({"ReportID"=0,"ElementCookie"=1,"CollectionType"=1,"Type"$\r\n    | |   |     | | |   |   "MouseButtonDivision" = 55\r\n    | |   |     | | |   |   "SetReportTimeoutMS" = 3500\r\n    | |   |     | | |   |   "BatteryLowNotificationType" = 1835887727\r\n    | |   |     | | |   |   "Manufacturer" = "Apple"\r\n    | |   |     | | |   |   "ConnectionNotificationType" = 1835885427\r\n    | |   |     | | |   |   "ProductID" = 781\r\n    | |   |     | | |   |   "IOPowerManagement" = {"CurrentPowerState"=1}\r\n    | |   |     | | |   |   "BatteryDangerouslyLowNotificationType" = 1836082284\r\n    | |   |     | | |   |   "DeviceUsagePairs" = ({"DeviceUsagePage"=1,"DeviceUsage"=2},{"DeviceUsa$\r\n    | |   |     | | |   |   "BD_ADDR" = <34159ed027aa>\r\n    | |   |     | | |   |   "BatteryPercent" = 45\r\n    | |   |     | | |   |   "MouseButtonMode" = "TwoButton"\r\n    | |   |     | | |   |   "ClassOfDevice" = 9600\r\n    | |   |     | | |   |   "DefaultMultitouchProperties" = {"parser-type"=2000,"parser-options"=4,$\r\n    | |   |     | | |   |   "BTHIDObjectID" = 148620288\r\n    | |   |     | | |   |   "InputReportElements" = ({"ReportID"=16,"ElementCookie"=73,"Size"=48,"R$\r\n    | |   |     | | |   |   "VendorIDSource" = 2\r\n    | |   |     | | |   |   "ReportInterval" = 11250\r\n    | |   |     | | |   |   "CFBundleIdentifier" = "com.apple.driver.AppleBluetoothMultitouch"\r\n    | |   |     | | |   |   "MaxOutputReportSize" = 1\r\n    | |   |     | | |   |   "IOCFPlugInTypes" = {"7DDEECA8-A7B4-11DA-8A0E-0014519758EF"="IOHIDFamil$\r\n    | |   |     | | |   |   "IOProviderClass" = "IOBluetoothL2CAPChannel"\r\n    | |   |     | | |   |   "LocationID" = 516958122\r\n    | |   |     | | |   |   "IOClass" = "BNBMouseDevice"\r\n    | |   |     | | |   |   "DisconnectionNotificationType" = 1835885683\r\n    | |   |     | | |   |   "DeviceName" = "Magic Mouse"\r\n    | |   |     | | |   |   "HIDDefaultBehavior" = "Mouse"\r\n    | |   |     | | |   |   "DefaultMultitouchPreferences" = {"MouseHorizontalSwipe"=2,"MouseMoment$\r\n    | |   |     | | |   |   "CountryCode" = 0\r\n    | |   |     | | |   |   "IOMatchCategory" = "IODefaultMatchCategory"\r\n    | |   |     | | |   |   "PrimaryUsage" = 2\r\n    | |   |     | | |   |   "IOProbeScore" = 1010\r\n    | |   |     | | |   |   "GetReportTimeoutMS" = 3500\r\n    | |   |     | | |   |   "IOGeneralInterest" = "IOCommand is not serializable"\r\n    | |   |     | | |   | }\r\n<\/pre>\n<\/div>\n
      \n
      Line 31 shows the battery percent of the object. \u00a0Line 15 shows the product that this ioreg object corresponds to. \u00a0Then at the very top you see a line that contains the object name (line 1).<\/p>\n<\/div>\n
      For more information on the ioreg I\/O kit registry tool in Mac OS X, please see the Mac OS X Manual.<\/div>\n
      \"Enhanced<\/a><\/div>\n","protected":false},"excerpt":{"rendered":"
      There are a few reasons why somebody might want to check the current battery percentage of a bluetooth mouse and\/or keyboard within Terminal on a mac. \u00a0Some that come to mind are for use in GeekTool, if you are connected to the computer remotely through ssh, etc. Well as it turns out, its actually very […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[3,11],"tags":[17,16,12,15,18,14,13,19],"class_list":["post-19","post","type-post","status-publish","format-standard","hentry","category-command-line","category-mac","tag-apple","tag-battery","tag-bluetooth","tag-geektool","tag-mac-os","tag-mac-os-x","tag-magic-mouse","tag-universal-serial-bus","no-thumb"],"_links":{"self":[{"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/posts\/19"}],"collection":[{"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/comments?post=19"}],"version-history":[{"count":5,"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/posts\/19\/revisions"}],"predecessor-version":[{"id":454,"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/posts\/19\/revisions\/454"}],"wp:attachment":[{"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/media?parent=19"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/categories?post=19"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/mattdturner.com\/wordpress\/wp-json\/wp\/v2\/tags?post=19"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}