Quartermaster is a native Sailfish OS Home Assistant client which aims to provide the same functionality like the offical Android/iOS app.
Home Assistant is an open source home automation platform written in Python.
The development is in alpha state at the moment. Not everythings works perfectly and needs testing.
This application is tested with Sailfish OS Versions:
Here is a list of all implemented features so far. Not all features listed below are finished or error free and are still in active development.
Features:
Available translations:
If you missing your native language you are welcome to support this project with your translation.
To get this app working with Home Assistant you need to activate the following components:
If you have "default_config:" in your configuration.yaml these components should already be active. If you need help please refer to Home Assistant Documentation.
You can get remote access by obtaining a Home Assistant Cloud account (paid subscription needed) or you need to make the server accessible by internet. For self hosting you need a dedicated IP by your provider (not shared one) and a dynamic DNS service because domain name is mandatory since version 0.77. Please refer to Home Assistant Documentation for details.
I don't have a cloud account, so no guarantee that this works with this app. In theory it should, all functionality is available for this.
Notifications can be received via websocket connection. At the moment only global notifications works (not device specific)
To send a notification you need to call the service "notify.notify" in Home Assistant:
service: notify.notify data: message: Tina comes home! title: Tina Location
The values "message" and ""title" need to have data!
Please refer to Home Assistant Documentation for details.
Authentication is only possible with a Long-Lived Access Token at the moment. You can create one in profile settings on your Home Assistant web interface.
Device tracking is turned of by default. You can activate it in the settings. Keep in mind that tracking will increase battery usage! For device tracking a remote access to Home Assistant is mandatory.
To work with the wifi tracking you need to define zones inside your Home Assistant server. Afterwards you can add wifi networks (AP) to the different zones in application settings.
When your device connects to a tracked network, the app will send the location coordinates of the zone linked to this network as the new device location.
You can help with the development of Quartermaster.
If you miss some functionality of some devices or you have an unsupported one, you can provide necessary data for development. In application settings you should turn on API logging to log all api traffic. Don't turn this on all the time, because it will generate a lot of data over time.
The files are stored in "Documents/harbour-quartermaster" folder. These files you can pack into an issue report here on GitHub.
This app is part of my plan to replace all android apps I use with native ones. If they don't exist, I will try to create one.
https://github.com/black-sheep-dev/harbour-quartermaster
If you like my work you can buy me a beer.
* Sun Jan 10 2021 Black Sheep <blacksheep@nubecula.org> 0.1.18-1 - Improvements of Web View
* Tue Dec 22 2020 Black Sheep <blacksheep@nubecula.org> 0.1.17-1 - Fixed for version number layout change of Home Assistant * Fri Oct 30 2020 Black Sheep <blacksheep@nubecula.org> 0.1.16-1 - Fixed desktop file for use of webview * Fri Oct 30 2020 Black Sheep <blacksheep@nubecula.org> 0.1.15-1 - Added new WebView component to show Home Assistant UI inside app - Fixed not renew device registration if webhookId expiered (e.g. at server restart) * Fri Oct 30 2020 Black Sheep <blacksheep@nubecula.org> 0.1.14-1 - Check if Home Assistant configuration is valid - UI improvements * Thu Oct 29 2020 Black Sheep <blacksheep@nubecula.org> 0.1.13-1 - Access Home Assistant informations in settings - Browse Home Assistant error log * Tue Oct 27 2020 Black Sheep <blacksheep@nubecula.org> 0.1.12-1 - Homezone settings and detection - UI improvements * Mon Oct 26 2020 Black Sheep <blacksheep@nubecula.org> 0.1.11-1 - Improved websocket connection - Basic Notifications over Websocket (see README on GitHub for details) - Code cleanup - Translation fixes * Sun Oct 25 2020 Black Sheep <blacksheep@nubecula.org> 0.1.10-1 - Backup & Restore function for settings (Wifi only at the moment) * Sun Oct 25 2020 Black Sheep <blacksheep@nubecula.org> 0.1.9-1 - Websocket integration for live entity states (off by default -> see settings) - Code cleanup * Sat Oct 24 2020 Black Sheep <blacksheep@nubecula.org> 0.1.8-1 - Fixed bug in webhook api using gzip compression * Thu Oct 22 2020 Black Sheep <blacksheep@nubecula.org> 0.1.7-1 - Increased maximal length of toplevel domain in connection settings from 5 to 8 * Thu Oct 22 2020 Black Sheep <blacksheep@nubecula.org> 0.1.6-1 - API request with gzip compression support to save bandwidth * Mon Oct 19 2020 Black Sheep <blacksheep@nubecula.org> 0.1.5-1 - Bugfixes - Improved UI components * Sun Oct 18 2020 Black Sheep <blacksheep@nubecula.org> 0.1.4-1 - Settings for automatic entity updates when showing up (List/Single). This is off by default * Sat Oct 17 2020 Black Sheep <blacksheep@nubecula.org> 0.1.3-1 - Bugfixes * Thu Oct 15 2020 Black Sheep <blacksheep@nubecula.org> 0.1.2-1 - Wifi tracking with available networks added * Thu Oct 15 2020 Black Sheep <blacksheep@nubecula.org> 0.1.1-1 - Input validation - Improved setup wizard * Tue Oct 13 2020 Black Sheep <blacksheep@nubecula.org> 0.1.0-1 - Initial release
Comments
daywalker
Tue, 2020/12/22 - 21:34
Permalink
for what reason does this app depend on sailfish-mdm package?
black_sheep_dev
Tue, 2020/12/22 - 21:47
Permalink
I used the mdm framework to get some device data e.g. Device UID for registration to Home Assistant and the sensor data like battery status, etc.. Is it a problem? It is an easy way to get this info. Are there any alternatives to get this data?
llv95dno
Sat, 2020/12/19 - 13:48
Permalink
Thank you, no rush. I wish you a merry christmas!
llv95dno
Fri, 2020/12/18 - 21:07
Permalink
It worked allright, no problem to connect. But after last version, it does not connect and refers to "Version of Home Assistant is incompatible with this app" Hass.io does not need a special account, it is just HA running with a docker container .
black_sheep_dev
Sat, 2020/12/19 - 10:47
Permalink
Jup I found the problem, they have changed the versioning in Home Assistant. 0.111.0 -> 2020.12.0.
I will fix it as soon I get my SDK running again. At the moment I cannot install it because of openssl > 1.0 issue.
llv95dno
Fri, 2020/12/18 - 00:10
Permalink
Hi, it seems that it does not accept Hass.io version 2020.12.0.
black_sheep_dev
Fri, 2020/12/18 - 20:21
Permalink
Hi there, did it work in a previous version? I don't have an hass.io account.
pasko
Mon, 2020/11/23 - 10:26
Permalink
Hi.
Thank you very much for the app.
Best regards.
robthebold
Thu, 2020/10/22 - 18:12
Permalink
In connection settings, quartermaster doesn't like my local domain -- I think using ".control" is too long for its taste. Can this limitation be lifted?
black_sheep_dev
Thu, 2020/10/22 - 18:52
Permalink
Increased top level domain to 8 characters in 0.1.7
piggz
Sun, 2020/10/18 - 14:58
Permalink
Very nice, thanks for this, was easy to set up, I just had to enable the mobile app plugin on my home assistant.
schmolle
Thu, 2020/10/15 - 23:56
Permalink
Nice one! Connected at the firs attempt. Danke!
Edit: The link in the description points to your "Kasa"-project instead of Quartermaster.
black_sheep_dev
Thu, 2020/10/15 - 23:58
Permalink
Thank you!
Damn Copy & Paste ...