openhab / openhab-windows

Universal Windows App for openHAB

Introduction

openHAB Windows application is a native client for openHAB 2 & 3. It uses REST API of openHAB to render sitemaps of your openHAB.

Builds

Code Analysis

The app project is using SonarQube hosted by SonarCloud to analyse the code for issues and code quality.

Quality Status

Branch	Quality Gate Status	Bugs	Code Smells
beta
main

Setting up development environment

If you want to contribute to the Windows application we are here to help you to set up development environment. openHAB Windows app is developed using Visual Studio 2019 and later.

• Download and install Visual Studio Community Edition
• During install, make sure to select UWP SDK 17763 and SDK 19041
• Check out the latest code from github
• Open the project in Visual Studio (File -> Open, Project/Solution)
• Rebuild the solution to fetch all missing NuGet packages

You are ready to contribute!

Before producing any amount of code please have a look at contribution guidelines

Trademark Disclaimer

Product names, logos, brands and other trademarks referred to within the openHAB website are the property of their respective trademark holders. These trademark holders are not affiliated with openHAB or our website. They do not sponsor or endorse our materials.

openhab-windows's Issues

Setting not available URI causes crash on save.

Exception in anonymous method in main view model constructor not handled.

Implement new design

A new design was created. discussion is here: https://community.openhab.org/t/design-proposal-please-pitch-in/16566/6

implementation is partially done

Rendering of the player element

The rendering if the player element is a little strange with only the >> on the second line.
As the 4 buttons cannot be on the same line, maybe we should have << and >> on one line and the 2 others on the other line ?

Windows 10 PC

Add webview widget

{ "widgetId": "0203_1_0_1_2", "type": "Webview", "label": "", "icon": "webview", "mappings": [], "height": 8, "url": "http://heise-online.mobi/", "widgets": [] }

Set up a build job

It would be good if we were able to build a binary from the sources on our Jenkins on cloudbees (https://openhab.ci.cloudbees.com/).

Not sure if Cloudbees supports the infrastructure to do this, but we should at least check this out.

change template of selected item in the sitemap list

Add selection widget

Slider has no initial state

[bug] Knob widget doesn't allow you to set "0" value

Environment / device: Lumia 735

Steps to reproduce:

1. Create a Dimmer item in your openHAB
2. In the Windows app try to set the minimum value for the dimmer (0)

Expected result:
Dimmer sets to OFF / 0

Actual result:
The item is stuck at 3

Here's also a screenshot I made on my wife's phone :-)
Cheers!

Add color picker widget

Color element not supported

Apparently, color elements are not yet supported.

Windows 10 PC

[bug] App crashes when you provide openHAB url without the port

Environment / device: Lumia 735

Steps to reproduce:

1. Open openHAB app
2. Press Settings button
3. Provide wrong openHAB url (in my case it was http://192.168.0.33 without :8080)

Expected result:
App shows an error informing about wrong URL

Actual result:
App crashes silently

Hey guys I wanted to thank you for your hard work! This app is a great opportunity for Windows Phone users to taste home automation system at its best :) Congratulations on your efforts!

Implement a go back to navigate backwards between linked pages

Frame widget: make icon smaller and next to label instead of above

Switch with mappings: no different rendering for the selected button

If you have a switch element with mappings, all buttons are rendered identically without a different rendering for the button corresponding to the current state.

Windows 10 PC

change style of settingspage to match design

The settingspage is currently styled very differently from the rest of the design. This needs to change so it matches the rest of the app

Add Mapview widget

{ "widgetId": "0202_3", "type": "Frame", "label": "Map/Location", "icon": "frame", "mappings": [], "widgets": [{ "widgetId": "0202_3_0", "type": "Mapview", "label": "Brandenburg Gate Berlin", "icon": "mapview", "mappings": [], "height": 10, "item": { "link": "http://demo.openhab.org:8080/rest/items/DemoLocation", "state": "52.5200066,13.4049540", "type": "Location", "name": "DemoLocation", "label": "Brandenburg Gate Berlin", "tags": [], "groupNames": [] }, "widgets": [] }] }

Switch widget does not have an initial state

Demo mode not working after fresh install

Demo mode is not working when starting the app after a new clean install without any settings.

update app to new Windows 10 SDK

min version: Anniversary
target version: Fall Creators Update

This way we support Windows 10 versions until over a year back

adjust style of ip cam widget to match new design

Use remote url when on mobile network

Implementation of the remote url like in HABdroid

Hide menu on the left side

On my mobile device (Lumia 650) the menu on the left side takes a lot of valuable space. I suggest to hide the menu by default. The store is doing the same. You just see the control to open the menu but nothing else.

Resolution is 1280 x 720 on a 5" device.

Charts are not rendered

No chart displayed.

Windows 10 PC

Sync app widgets with openHAB server

the widgets should respons to actions taken from other clients.

for example:
when I change a slider value from an android device with habdroid, the corresponding widget on the windows app should set the new value as well so that the app stays in sync with the server

valuecolor conditions not taken into account

The app seems to ignore valuecolor conditions of a sitemap element.

I have not tested the labelcolor conditions.

Windows 10 PC

Wrong button for switch element linked to dimmer light

If one of my dimmmer lights is ON, after opening Windows app, it looks as OFF with the button "Off" surrounding with black.

It happens only for switch elements linked to dimmer item, not for switch element linked to switch item.

Windows 10 PC

Remember current sitemap

re-open current sitemap on app restart

Critical issue: widget state not updated

If you change the state with another UI for example of a light, the state is not updated in Windows app. Switching to the main page and then returning to the sub-page changes nothing.
It looks like the app is not "listening" to events coming from the server.

Windows 10 PC

[bug] Sitemap type setpoint not working

In my sitemap I have defined a frame with a setpoint:

  Frame label="Bad" {
	    Text item=HeizungBad_4_ActualTemperature   label="Aktuelle Temperatur [%s °C]" valuecolor=[>30="red",>20="orange",>15="green",>1="green",<=1="blue"]
		 Setpoint item=HeizungBad_4_SetTemperature  label="Neue Temperatur" minValue="5" maxValue="23" step="0.5"
		 Switch item=Fenster_Bad label="Fenster"
	}

It is display as this:

create rollershutter widget

Rollershutter widget is currently working like a switch with simple on / off state.
needs to be conform to HabDROID with 3 buttons, up / stop / down and using the mappings as labels

Implementing demo mode

Implementing of demo mode for the Windows app

change logo to new openHAB logo

Frame widget layout

Frame widget shows title twice and is pushed down too much

Icon of a widget is not depending on item state

The icon of a widget seems to be independent on the item state. Normally, it should be different for example for a light when the light is ON or OFF.

Windows 10 PC

icons, splashscreen, app title

Image item not supported

Image element linked to an image item are apparently not supported (no image displayed).

Windows 10 PC

SwitchWidget should use styled framework control like ToggleSwitch

So it would be easy to update values and perform actions with databinding.

Rework sectionswitch

A switch with multiple options is currently shown as a combobox. this would be better with togglebuttons in a wrappanel

Slider only responds to drag, not to click

enable username / password connections

Currently only unauthorized connections are possible with the app.

enable the use of username / password secured connections to openHAB server

Transparent LiveTile

Should be supported so that the start screen is not disturbed when the app is pinned.

Can't run App from within VS 2015

The build was ok. But when I start debug or release from VS 2015 the app crashes with NULL pointer exception.

Text truncated for String elements

When you have a long text in a String item, the text appears on one unique line and truncated at keft.
Maybe it could rather be truncated at right with "..." to show that it is truncated, and maybe you could display it on several lines (there is place for that).

Windows 10 PC

No way to return to the parent page

The arrow at top left allows returning to the main page but there is no way to return to the parent page.

Windows 10 PC

edit background image to make titles more clear

Capability "Private Networks" not set in manifest

This causes System.Net.Http.HttpRequestException with inner exception System.UnauthorizedAccessException when setting openHAB uri to a lokal instance.

Create section switch widget

create a widget for a section switch item

[enhancement] Ability to turn off or change the background image/color

It would be a nice addition to the app if one could change the background color or image.
Sorry for so much tickets at once! :) Just wanted to put it all out there so it's easier to track it.
Again, great job, gentlemen!
Thank you

Cannot use SSL with untrusted certificates

Setting the HTTPS URL leads to "Invalid URL, check your settings".

Windows 10 PC