Kurzanleitung [smartVISU]

Configuration

Global
Pages 'kurzanleitung'
Client (Cookie)

Global system settings (in ./config.ini).

User Interface

General Settings

Pages

Defines which of the pages in the ./pages folder is displayed by default.

Design

Defines the look and feel.

Title

Page title in the browser tab.

Language

Sets the language to be used by smartVISU.
Further translations are appreciated!
Note: Not all widgets are multi-lingual.

Cache

Are pages to be cached for faster loading? The cache needs to be cleared to apply page changes (=switch off for pages under development).

Behaviour

Animation

Use animation between pages.

Back to home

Seconds of inactivity until home page is shown.
Set to 0 to disable returning automatically.

Time

Which time to be used by clock widgets?
client = time of your device
server = smartVISU server time

Timezone

Timezone of the server's location (!)

SmartHome/IoT data source

Data connection / driver

System

Which system gathers the data?

Host/IP

Host name or IP address the system can be reached at (e.g. 192.168.1.2)
If left empty hostname of HTTP request will be used in most systems.

Port

The port the system can be reached at, e.g.:
1028 - LinKNX
2121 - FHEM
2424 - smartHomeNG
If left empty the port of HTTP request will be used in most systems.

TLS-Port

The port for TLS-encrypted communication, e.g. 2425 with smartHomeNG. The driver uses this port if the visu page is called via HTTPS.

Realtime data

Observe system online for data changes?

Reconnect

Automatically reconnect in case of a connection drop?

Rev. Proxy

If the server is configured as reverse proxy the fields for IP address and port must be empty

Console

Consoleport

The port the console can be reached at, e.g.:
8101 - OpenHAB

Username

The username for authentication on the console.

Password

The password to the username.
ATTENTION: The password is saved unencrypted in config.ini.

Authentication / Security

SSL

Activate for encrypted communication with the server and, if necessary, adjust the port settings to the SSL port, if different from 443.
Recommended when using authentication with a password.
ATTENTION: The server's certificate must be trustworthy on the client, otherwise the connection is refused.

Username

The username or API token for authentication on the server.

Password

The password for the username. Usually empty when using an API token.
ATTENTION: The password is saved unencrypted in config.ini and if SSL is not activated it is also transmitted unencrypted to the server.

smartVISU Host Name / Proxy Server

SV Host Name

If smartVISU gets called with its host name in the internal net,
e.g. as smartVISU.local, the host name must be entered here. (optional if IP address is being used)

Proxy

Activate this setting if the smartVISU server is connecting to the Internet through a proxy server.

Host/IP

The address of the proxy server.

The user name for login to the proxy server.

Password

The password for login to the proxy server.

Other Data Sources

Weather

Provider

Name of the weather service.

City

Your location in the format of your weather service
(e.g. Germany/Bayern/Würzburg/)
or your Wunderground station code

API Key

Your key / password if you are a registered user of the service (required by some services, otherwise number of requests per hour / day may be limited).

Postal code

Postal code : Country code, e.g. 70000:DE

Phone

System

The driver to be used for your phone system.

Host/IP

Host name or IP address to acccess your phone system (e.g. 192.168.1.1)

Port

The port to access your phone system (if required).

The user name for logging in to your phone system (e.g. admin).

Password

The password for logging in to your phone system.

Calendar

Provider

The driver to be used for your calendar service.

URL(s)

The address for connecting to your calendar service.
For ICS/iCal, you can add more than one URL, separated by whitespace.

The user name to be used for login at the calendar provider (if required).

Password

The password to be used for login at the calendar provider (if required).

Calendars

One or more calendar names to be read (separated by comma, e.g. calendar1,calendar2)

Color(s)

Default colors for the above calendar(s), in the same order.

Hide private

Hide private info by showing titles of private entires as "private appointment"

Access

Authorize Google Data Access

Authorize

Options

Functions

Check for updates

Look on smartvisu.de and github for a newer version.

Reset menus

The collapsible groups in the rooms menu are returned to their default states on every return to a page. (Deactivated: last selection of the user is kept per page.)

Item loopback

After sending commands from the visu, item gets updated only by an answer of the backend. (Deactivated: item gets updated immediatly inside smartVISU.)

Websocket signal

Lets the smartVISU logo blink until all subscribed items have been received from the backend.

Settings for the selected page only (in /pages/kurzanleitung/config.ini).

User Interface

General Settings

Pages

Defines which of the pages in the ./pages folder is displayed by default.

Design

Defines the look and feel.

Title

Page title in the browser tab.

Language

Sets the language to be used by smartVISU.
Further translations are appreciated!
Note: Not all widgets are multi-lingual.

Cache

Are pages to be cached for faster loading? The cache needs to be cleared to apply page changes (=switch off for pages under development).

Behaviour

Animation

Use animation between pages.

Back to home

Seconds of inactivity until home page is shown.
Set to 0 to disable returning automatically.

Time

Which time to be used by clock widgets?
client = time of your device
server = smartVISU server time

Timezone

Timezone of the server's location (!)

SmartHome/IoT data source

Data connection / driver

System

Which system gathers the data?

Host/IP

Host name or IP address the system can be reached at (e.g. 192.168.1.2)
If left empty hostname of HTTP request will be used in most systems.

Port

The port the system can be reached at, e.g.:
1028 - LinKNX
2121 - FHEM
2424 - smartHomeNG
If left empty the port of HTTP request will be used in most systems.

TLS-Port

The port for TLS-encrypted communication, e.g. 2425 with smartHomeNG. The driver uses this port if the visu page is called via HTTPS.

Realtime data

Observe system online for data changes?

Reconnect

Automatically reconnect in case of a connection drop?

Rev. Proxy

If the server is configured as reverse proxy the fields for IP address and port must be empty

Console

Consoleport

The port the console can be reached at, e.g.:
8101 - OpenHAB

Username

The username for authentication on the console.

Password

The password to the username.
ATTENTION: The password is saved unencrypted in config.ini.

Authentication / Security

SSL

Username

The username or API token for authentication on the server.

Password

smartVISU Host Name / Proxy Server

SV Host Name

If smartVISU gets called with its host name in the internal net,
e.g. as smartVISU.local, the host name must be entered here. (optional if IP address is being used)

Proxy

Activate this setting if the smartVISU server is connecting to the Internet through a proxy server.

Host/IP

The address of the proxy server.

The user name for login to the proxy server.

Password

The password for login to the proxy server.

Other Data Sources

Weather

Provider

Name of the weather service.

City

Your location in the format of your weather service
(e.g. Germany/Bayern/Würzburg/)
or your Wunderground station code

API Key

Your key / password if you are a registered user of the service (required by some services, otherwise number of requests per hour / day may be limited).

Postal code

Postal code : Country code, e.g. 70000:DE

Phone

System

The driver to be used for your phone system.

Host/IP

Host name or IP address to acccess your phone system (e.g. 192.168.1.1)

Port

The port to access your phone system (if required).

The user name for logging in to your phone system (e.g. admin).

Password

The password for logging in to your phone system.

Calendar

Provider

The driver to be used for your calendar service.

URL(s)

The address for connecting to your calendar service.
For ICS/iCal, you can add more than one URL, separated by whitespace.

The user name to be used for login at the calendar provider (if required).

Password

The password to be used for login at the calendar provider (if required).

Calendars

One or more calendar names to be read (separated by comma, e.g. calendar1,calendar2)

Color(s)

Default colors for the above calendar(s), in the same order.

Hide private

Hide private info by showing titles of private entires as "private appointment"

Access

Authorize Google Data Access

Authorize

Options

Functions

Check for updates

Look on smartvisu.de and github for a newer version.

Reset menus

The collapsible groups in the rooms menu are returned to their default states on every return to a page. (Deactivated: last selection of the user is kept per page.)

Item loopback

After sending commands from the visu, item gets updated only by an answer of the backend. (Deactivated: item gets updated immediatly inside smartVISU.)

Websocket signal

Lets the smartVISU logo blink until all subscribed items have been received from the backend.

Settings for the current client only (stored as cookie).

User Interface

General Settings

Pages

Defines which of the pages in the ./pages folder is displayed by default.

Design

Defines the look and feel.

Title

Page title in the browser tab.

Language

Sets the language to be used by smartVISU.
Further translations are appreciated!
Note: Not all widgets are multi-lingual.

Cache

Are pages to be cached for faster loading? The cache needs to be cleared to apply page changes (=switch off for pages under development).

Behaviour

Animation

Use animation between pages.

Back to home

Seconds of inactivity until home page is shown.
Set to 0 to disable returning automatically.

Time

Which time to be used by clock widgets?
client = time of your device
server = smartVISU server time

Timezone

Timezone of the server's location (!)

SmartHome/IoT data source

Data connection / driver

System

Which system gathers the data?

Host/IP

Host name or IP address the system can be reached at (e.g. 192.168.1.2)
If left empty hostname of HTTP request will be used in most systems.

Port

The port the system can be reached at, e.g.:
1028 - LinKNX
2121 - FHEM
2424 - smartHomeNG
If left empty the port of HTTP request will be used in most systems.

TLS-Port

The port for TLS-encrypted communication, e.g. 2425 with smartHomeNG. The driver uses this port if the visu page is called via HTTPS.

Realtime data

Observe system online for data changes?

Reconnect

Automatically reconnect in case of a connection drop?

Rev. Proxy

If the server is configured as reverse proxy the fields for IP address and port must be empty

Console

Consoleport

The port the console can be reached at, e.g.:
8101 - OpenHAB

Username

The username for authentication on the console.

Password

The password to the username.
ATTENTION: The password is saved unencrypted in config.ini.

Authentication / Security

SSL

Username

The username or API token for authentication on the server.

Password

smartVISU Host Name / Proxy Server

SV Host Name

If smartVISU gets called with its host name in the internal net,
e.g. as smartVISU.local, the host name must be entered here. (optional if IP address is being used)

Proxy

Activate this setting if the smartVISU server is connecting to the Internet through a proxy server.

Host/IP

The address of the proxy server.

The user name for login to the proxy server.

Password

The password for login to the proxy server.

Other Data Sources

Weather

Provider

Name of the weather service.

City

Your location in the format of your weather service
(e.g. Germany/Bayern/Würzburg/)
or your Wunderground station code

API Key

Your key / password if you are a registered user of the service (required by some services, otherwise number of requests per hour / day may be limited).

Postal code

Postal code : Country code, e.g. 70000:DE

Phone

System

The driver to be used for your phone system.

Host/IP

Host name or IP address to acccess your phone system (e.g. 192.168.1.1)

Port

The port to access your phone system (if required).

The user name for logging in to your phone system (e.g. admin).

Password

The password for logging in to your phone system.

Calendar

Provider

The driver to be used for your calendar service.

URL(s)

The address for connecting to your calendar service.
For ICS/iCal, you can add more than one URL, separated by whitespace.

The user name to be used for login at the calendar provider (if required).

Password

The password to be used for login at the calendar provider (if required).

Calendars

One or more calendar names to be read (separated by comma, e.g. calendar1,calendar2)

Color(s)

Default colors for the above calendar(s), in the same order.

Hide private

Hide private info by showing titles of private entires as "private appointment"

Access

Authorize Google Data Access

Authorize

Options

Functions

Check for updates

Look on smartvisu.de and github for a newer version.

Reset menus

The collapsible groups in the rooms menu are returned to their default states on every return to a page. (Deactivated: last selection of the user is kept per page.)

Item loopback

After sending commands from the visu, item gets updated only by an answer of the backend. (Deactivated: item gets updated immediatly inside smartVISU.)

Websocket signal

Lets the smartVISU logo blink until all subscribed items have been received from the backend.

Sign in to Google Developer Console and select APIs and Services.
Under Select a Project (top left beside Google Cloud) select NEW PROJECT.
Enter a Project Name, e.g. "smartVISU calendar" and click on CREATE.
- Wait while the project gets created.
Enter your Google account as test user in the section Oauth consent under APIs and Services.
Select Google Calendar API from the Library under APIs and Services and click ENABLE.
Click on Create credentials on top right.
1. Select Google Calendar API under Which API are you using?
2. Select User data under What data will you be accessing? and click NEXT.
If the OAuth consent section opens enter an App name, e.g. "smartVISU".
1. Provide your own email address under User support email and Developer contact information.
2. Click SAVE AND CONTINUE.
The section Scopes (optional) may be left empty. Click on SAVE AND CONTINUE.
In the section OAuth-Client-ID select Web application under Application type.

Enter a Name for the application, e.g. "smartVISU".
Copy & paste the following specific URI to Authorized JavaScript origins. Exact match is important!
Authorized redirect URIs may be left empty.
Click on CREATE.

You will then see your Client-ID in the section Your Credentials. Click on Download, save the file and click DONE.
Select this file here: If the fields client ID and client secret below don't get filled:
Open the file, look for values of client_id and client_secret and enter them.
Click on Authorize below.
Log in if asked and click on NEXT several times in opened window.
- The popup window and this dialog should close afterwards. Authorization procedure is completed now.
Don't forget to save the configuration page.

google_json_text

Client-ID:

Client Secret:

Configuration

Global system settings (in ./config.ini).

User Interface

General Settings

Behaviour

SmartHome/IoT data source

Data connection / driver

Console

Authentication / Security

smartVISU Host Name / Proxy Server

Other Data Sources

Weather

Phone

Calendar

Options

Functions

Settings for the selected page only (in /pages/kurzanleitung/config.ini).

User Interface

General Settings

Behaviour

SmartHome/IoT data source

Data connection / driver

Console

Authentication / Security

smartVISU Host Name / Proxy Server

Other Data Sources

Weather

Phone

Calendar

Options

Functions

Settings for the current client only (stored as cookie).

User Interface

General Settings

Behaviour

SmartHome/IoT data source

Data connection / driver

Console

Authentication / Security

smartVISU Host Name / Proxy Server

Other Data Sources

Weather

Phone

Calendar

Options

Functions

Configuration

Template checker

Widget Assistant

Backup config

Documentation

Kurzanleitung (Deutsch)

Support on knx-user-forum

Sources on Github

New widgets and supplements

Team

Credits

Copyright