Warning ! The current version in this develop branch is experimental and should not be used in productive environments!
Use version v3.4 from master branch instead.
smartVISU is a framework to create a visualisation for smart home environments with simple html-pages.
It can be used with several smart home automation backends or directly on KNX.
Page programming is done in HTML with a powerful collection of pre-defined widgets. Pages of various example houses can be copied to simplify creation of a custom visualisation.
An integrated live documentation shows usage and parametrsation of the widgets. A widget assistant helps with parametrisation and live testing of widgets and a template checker checks for correct page syntax.
SEE: smartvisu.de
- Pretty: Responsive design, auto adjustment to smartphones and tablets
- Strict: One template for all devices
- Easy: Implementation with HTML5 and configurable widgets
- Simple: Various examples allow a visu creation with very low programming skills
- Universal: Powerful widgets for all visualisation purposes
- Connectable: Drivers adapt the visu to different smart home environments
- Supportive: An active community is ready to assist in the support forum
- IP-Network and / or KNX-Bus
- smarthomeNG, linknx, ioBroker, openHAB, FHEM or knxd (deprecated: eibd ) backend or JSON interface
- Webserver with PHP 7.3.2 and above (PHP >=8.0 recommended). Compatibility with PHP v8.4 is verified. PHP packages required: libawl-php php-curl php php-json php-xml php-mbstring
- Firefox, Chrome, IE, Safari, iPhone, iPad, Android Phone or Android Tablet
-
if you are using Apache2 as web server make sure the following php packets are installed: libawl-php, php-curl, php, php-json, php-xml, php-mbstring
-
the server directory is /var/www/html. Create a subdirectory "smartVISU" (or any other name), set the rights for your user and copy / clone the smartVISU package to that directory (be sure to type the dot at the end of the last line).
sudo mkdir smartvisu sudo chown smarthome:www-data smartvisu chmod g+rws smartvisu/ cd smartvisu git clone https://github.com/Martin-Gleiss/smartvisu.git . -
Afterwards set the rights for the temp folder and some system configuration and data files:
bash setpermissions
For your own Project do the following:
- Create a new directory in "pages", for example "pages/YOURPROJECT".
This is your individual project-directory where you may work.
Copy all files from "pages/_template" to your project-directory - Call smartVISU in your browser (http://localhost/smartVISU) and proceed to the configuration page. Select "YOURPROJECT" in the user interface section.
- Select your smart home backend in the "smarthome/IoT data source" section
- linknx: for linxknx and eibd environment
- smarthomeNG: for SmartHomeNG environment
- ...
- knxd / eibd: for direct access
- offline: only for testing, all GADs will be stored in a textfile ("temp/offline_YOURPROJECT.var")
- Create a new page in your project-directory, for example "mypage.html". Note: Do not use "base.html, basic.html, device.html" nor any other reserved name of the system pages.
- Fill the page with your preferred content and widgets (see the pages/example*.* sections). The widget assistant in the system menu will help you to parametrize the widgets correctly.
- If you need to change the design, select a design in the user interface section.
If you want to develop your own widgets, place them in ./dropins/widgets (preferred) or ./pages/YOURPROJECT/widgets.
Provide a mywidget.html and a mywidget.js (if you need one). The files will be imported automatically.
Avoid names which are already used in the "smartvisu/widgets" directory or other sytem file names. - Test your page with: http://localhost/smartVISU/index.php?page=mypage
Note: replace "localhost" with the hostname or IP address from your server - Create all pages you need. The template checker will check the formal correctness of the completed set of pages.
- At the end of your project set "cache" to "on" in the user interface area to speed up your smartVISU
- Enjoy smartVISU!