Battery Status‎ > ‎

Learn More About Override



Mac OS X Apps

iOS Apps

Learn More about

Battery Status Preferences


    If Battery Status will be running on a computer where it’d be preferable if ordinary users couldn’t change certain preferences, then administrators may be interested in knowing how to override Battery Status Preferences.


How Administrators can Override Battery Status Preferences

    Administrators are capable of overriding Battery Status Preferences by opening a hidden preference file, called “.Override” located in the Resources folder of the app bundle. The easiest way of accessing this file is by using the Terminal commands cd to navigate into the bundle, and then the terminal command open to open the file in any application that can edit plists (TextEdit will work if nothing else is available.)


Here are example commands to access and open .Override:

$ cd /Applications/Battery\ Status.app/Contents/Resources/

$ open -a TextEdit .Override


    If this file has been opened in a text editor, look for the <key> tags. Between the tags <key> and </key> , the name of each preference is given. Beneath each key is either the override setting for the preference, or sub-preferences stored between <dict> and </dict> tags and also named between <key> and </key> tags. Most preferences may only be turned on or off, a setting denoted by a <true/> or <false/> tag, respectively. Some preferences, such as Reflected Device’s Override To, may be set to an integer. To change these, simply provide a valid integer between the <integer> and </integer> tags. The table below explains each of the settings.


Key

Explanation

Hide Preferences
Menu Item
When enabled, the “Preferences…” menu option won’t appear, and thus the Preferences will not be accessible by ordinary users.

Hide Quit
Menu Item
When enabled, the “Quit” menu option won’t appear, and thus Battery Status may not be quit by ordinary users.
Override




This is a sub-preference for many other preferences that will:
- Gray out the corresponding preference item in the ordinary preference window, thus disallowing the user to change it.
- Force Battery Status to use the preference provided by the corresponding “Override To”.
Override To


This is a sub-preference for many other preferences. Refer below to find what settings are valid, as well as explanations as to what they do, for specific preferences.
Display Percent
When enabled, the percent remaining will be displayed alongside the Battery Status icon.
Black and White




When enabled, most graphics in Battery Status will be displayed in black and white. The two exceptions are:
1 - The fill color for a battery below 25% will still be red.
2 - The “green charging plus”, if displayed, will still be green.

Green Charging Plus


When enabled, a green plus will appear on the left side of the Battery Status icon whenever the battery is plugged in.

Reflected Device







This setting dictates how Battery Status decides which battery should be reflected by the main icon, if more than one are available. It accepts an integer:
0 - The external device with the lowest charge will be reflected.
1 - The internal battery will be reflected regardless of the charge percent of any external devices that may be connected.
Note: In Battery Status 1.3, anything else is technically undefined, but will probably behave the same as 0.
Broadcast



When enabled, Battery Status will share everything it knows about batteries connected to the computer with other instances of itself running on other computers that have receive set to enabled. 
Receive



When enabled, Battery Status will collect broadcasts from other instances of itself running on other computers that have broadcast set to enabled, and display the data contained in the “Broadcasts from Local Network” menu item.
Local External
Death Warning*
When enabled, Battery Status will present a warning when the batteries in a connected device drop below 7%, indicating that the death of the batteries is imminent.
Local Internal
Death Warning*
When enabled, Battery Status will present a warning when the batteries in the computer drop below 7%, indicating that the death of the computer is imminent.
Local Internal
Charged Warning*
When enabled, Battery Status will present a warning when the batteries in the computer rise above 99%, indicating that computer is fully charged and ready to be unplugged.
Remote External
Death Warning*†


When enabled, Battery Status will present a warning when the batteries in a connected device at a different computer drop below 7%, indicating that the death of the batteries is imminent.

Remote Internal
Death Warning*†
When enabled, Battery Status will present a warning when the batteries in a different computer drop below 7%, indicating that the death of the computer is imminent.
Remote Internal
Charged Warning*†


When enabled, Battery Status will present a warning when the batteries in a different computer rise above 99%, indicating that computer is fully charged and ready to be unplugged.

* Warnings will be displayed using Notification Center on computers running OS X 10.8 (Mountain Lion) or newer, or as alert windows on computers running prior versions of OS X.

† Remote Warnings will only be displayed if Receive is enabled.

Comments