BitBar V2: Display & Control SmartThings from the macOS Menubar
ST BitBar V2 can monitor SmartThings devices/sensors from the Apple macOS Top Menu Bar using freeware BitBar software and installing this customized SmartThings integrated BitBar plugin and legacy mobile ST SmartApp.
ST BitBar V2 can display and control your SmartThings thermostats, locks, switches, dimmers, routines and modes. It also displays temperature, contact, presence, motion sensors along with battery levels and historical events for selected devices. There is now extensive control of menu & submenu titles, emojis, fonts, colors, pitches and battery warning levels defined by the user in the SmartThings mobile client.
How to Install/Upgrade:
- Follow the detailed installation instructions.
Existing STBitBarApp V1 Users
Update your SmartThings IDE GitHub REPO name in the SmartThings IDE “My SmartApps” under settings as follows.
Name Value Owner kurtsanders Name: STBitBarApp-V2 Branch master
Perform an Update from Repo to install and publish BitBar Output App .
If you upgrade SmartApps manually, replace the V1 bitbar-output-app.groovy with the new version. Save and Publish.
Replace the following local files (located in your Mac BitBar Plugin Directory on your Mac ) with same files for previous release. Rename if needed.
Do Not replace your ST_Python_Logic.cfg file which contains your personal SmartThings URL and Secret.
Features added in Versions 2.xx & 3.xx
- Added Past Device History Events to selected devices (Motion Sensors, Presence Sensors) and modified the GUI with user options for control of the number of past events displayed and date-time format (12/24)
- Added support for Extended ASCII Characters in Main Menu, Modes and Routine Names
- Added additional control of Font Names, Font Colors and Font Pitch Sizes in the GUI used by the Apple BitBar display
- Added logic for Low Battery Warning Level and Emoji Selection in the GUI when Mac Option key is held and BitBar is displayed
- Better formatting of the API URL and Secret displayed in the ST Live Logging Screen and GUI
- Redesigned the GUI into more Sections with Links to valid Apple Font Names and Emoji names
- Added new Program Version Information and Read-Only view of GUI Active Options from the BitBar Actions & Shortcuts menu (at bottom on BitBar)
- Cleaned up the Thermostat Display Controls
- Added control of section horizontal bars
- Changed display format for Modes and Routines
- Redesigned BitBar Actions & Shortcuts menu (at bottom on BitBar)
- GitHub ReadMe file enhanced to help with new user installation
New Features in Beta 4.x.x :
- Allow one ST device of either a lock, contact, switch, or temperature sensor to be designated in the BitBar Top Menu. Red & green emoji’s will be shown in the top Mac menu bar for the selected device status with a lock, contact or switch. A integer value will be displayed when a temperature sensor is designated.
- Provide a MacOS right sidebar notification alert when:
- Acknowledging a requested device change from the BitBar Menu Bar
- Showing the timed device status refresh
- Allow user to turn On|Off MacOS sidebar notifications for routine status polling and device changes
- Provide an user defined automatic device refresh after a ST device change from BitBar Output (default 5 sec after device change which allows time for the device to report status to ST Cloud API)
- Allow the secret API strings to be SMS delivered (unencrypted) to a USA mobile phone number from the API Setup Page for new users to copy to the ST_Python_Logic.cfg file.
- Added the following information in the mobile ST BitBar Output SmartApp main menu for:
- ST BitBar Output SmartApp Version
- ST_Python_Logic.py Version
- ST.xm.sh Version (where ‘x’ is an integer number (default is now 1) reflecting the number of minutes for normal pooling of devices defined to BitBar Output App. Please do not change this to less than 1m which pools to frequently and will impact Mac performance. If you would like a slower polling rate, I recommend ‘3m’ or ‘5m’ for ‘x’ in ST.xm.sh file
- BitBar Plugin Folder Location