This project in no longer supported for SmartThings as the updated ST Mobile UI has too many issues and a undetermined future. Therefore, I have decided to provide only a Hubitat version going forward.
BitBar V2: Display & Control SmartThings from the macOS Menubar
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.
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.
ST_Python_Logic.py
ST.1M.sh
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
I just updated and noticed in the Version Information of the BitBar app, it shows Not Installed for the ST_Python_Logic.py and BitBar Plugin Directory. Did I do something wrong or is that a feature coming in a future release?
Answer: That extended version information gets populated when the new V2.3 ST_Python_Logic.py file gets installed in your local BitBar Plugins directory and runs/refreshes for the first time which sends this Python version version information to the SmartThings SmartApp. Here is my SmartApp screen when both are at 2.3.
still getting the same. Under STBitBarApps Actions and Shortcuts: Your Current Running Program Version Information shows BitBar OutPut App v2.30 and ST_Python_Logic.py v.2.30. Tried refresh, quitting the bitbar app, quitting the ST app and reloading it.
Also, Under STBitBarApps Actions and Shortcuts: Launch Browser to View BitBarApp v2.30 Github Software Resp takes me to the old Resp @ https://github.com/kurtsanders/STBitBarApp
@jkp: Thank for finding this: I just updated the ST_Python_Logic.py incorrect link āUnder STBitBarApps Actions and Shortcutsā to the correct new STBitBarApp-V2 repo. Please update and replace the previous.
If you wouldnāt mind, please double/triple check that you have all the new code re-installed (both on the Mac BitBar Plugin directory and SmartThings āMy SmartAppsā from the **newSTBitBarApp-V2 GitHub Repo. The old V1 versions are <2.30, so it looks like you have the correct files installed. How about checking to make sure you do not have any V1 files left in either the SmartThings IDE or the BitBar Plugin directory.
I created a brand new GitHub repo name for V2, which might cause some issues with V1 users still pulling updates from the OLD GitHub without the ā-V2ā suffix. I have rename the old V1 repo with DEPRECIATED and this will result in V1 customers just getting a REPO message that their V1 repo is not valid. They will need to change their repo name to STBitBarApp-V2 or replace the V1 code manually by cut & paste.
Here is what your SmartThings IDE āMy SmartAppsā row for the BitBar Output APP should show. Note the new icon being a blue outer ring around the Black Inner circle, the new STBitBarApp-V2 (master) name and Published.
Hi looking for some help here. I did make the SmartApp updated as well as the Python and ST.5M file. When I open BitBar it says Error While communicating with ST API.
here is the error from the ST logs:
5:52:13 PM: error java.lang.ClassCastException
Generally that error means that the ST_Python_Logic.py BitBar plugin is not able to communicate with SmartThings: Here are a few things you can look for that might cause this error:
Insure that you have Enabled OAuth for the BitBar Output App in the SmartThings IDE: At the My SmartApps page, click the little Edit Properties icon for the BitBar Output App, then click OAuth section, then click Enable OAuth in SmartApp.
Then follow Section 2 instructions to get your specific SmartThings URL and secret text strings from the BitBar Output App.
Edit your ST_Python_Logic.cfg file using Appleās textedit command (or your favorite Text file Editor to insure that you have added your specific SmartThings URL and Secret strings from the BitBar Output App as I have shown the example below:
Thanks for the detailed instruction, I tried but Iām still getting the same error. I will try to delete completly and start from scratch maybe that will help
Edit: I just did a complete re-install but Iām still getting the same error again
I followed the existing-user-update instructions in the OP here, and it worked great.
I have a relatively simple BitBar setup (I just need a few basic things there), but itās all working well, and it looks great! Thank again for all your hard work on this project, Kurt - this is a fantastic gem of convenience!
Thanks @Hydro for the positive feedback and Iām sure your # of devices will grow now that you can see and control them from the macOS and mobile clients.
I recognize that the installation of this application is far too many steps for the typical user. Iām investigating either creating either a pre-packaged BitBar/Plugin as a single install package, or a basic YouTube video.
There are several complicated areas where the install can fail for the user, so if there are any useful tips that I need to include in the setup instructions or automate that would help others, please feel free to identify them, and I will correct.
You may accidentally downloaded the script(s) as HTMLā¦ you need to download the script(s) by clicking on the GitHubās Raw button and copy and pasting the code on a text editor and saving it to the folder for your plugins.
Hi Kurt
Getting this error
Traceback (most recent call last):
File ā/Users/Lucky/Documents/BitBarPlugin/ST/ST_Python_Logic.pyā, line 500, in
print āāMode ({})ā.format(thermostat[āthermostatModeā].title()), buildFontOptions(3)
AttributeError: āNoneTypeā object has no attribute ātitleā
Thanks for finding this error. What type of thermostat do you have? This error appears to be related to your thermostat not providing a current āOperating Modeā, like Heat, Cool. Auto, Off. I might need to change code for those few thermostats that do not provide an expected
Glad to hear!