Web front end for the home automation software Jeedom

Vue-dom

Vue-dom is a web front end for home automation software (currently only support Jeedom).

Key features

display rooms with summary,
display room with logical equipments,
display logical equipments by tags,
display info statistics (min, average and max) and history chart,
display and start scenarios,
display system notifications,
ask query (interaction),
user authentication with login and password (not stored in application),
communicate with your back-end software through JSON-RPC API and websocket, authorized with user API key,
reduce data traffic,
responsive,
progressive web app (offline access).

Check out the live demo (since using mock data, there is no effective action and inconsistencies may occur).

Installation

For basic use, you just have to:

download latest release tar.gz archive,
unarchive in /var/www/vue-dom/,

add following lines in Apache virtual hosts /etc/apache2/sites-enabled/default-ssl.conf and /etc/apache2/sites-enabled/000-default.conf, inside <VirtualHost> section:

        alias /vue-dom/ /var/www/vue-dom/
        <Directory /var/www/vue-dom>
                Options -Indexes -FollowSymLinks -MultiViews -ExecCGI
                AllowOverride none
                Order allow,deny
                allow from all
        </Directory>

set your back end (Jeedom) url in /var/www/vue-dom/local.js.

If you are using Docker, you can download the Dockerfile and build image with your own url:

docker build \
-f Dockerfile \
-t nioc/vue-dom:nginx-alpine-latest \
--build-arg JSON_RPC_API_URL=https://192.168.1.50/core/api/jeeApi.php \
--build-arg WEBSOCKET_URL=wss://192.168.1.50/socket/ .

And then run application in container:

docker run -d -p 80:80 --rm --name vue-dom-1 nioc/vue-dom:nginx-alpine-latest

For more advanced use (adding your own component, style, …), you have to follow the contributing guide and edit Vue code.

Versioning

Vue-dom is maintained under the semantic versioning guidelines.

See the releases on this repository for changelog.

Contributing

If you have a suggestion for a feature you think would enhance this product, please submit a feature request. Pull requests are welcomed. See contributing.

Credits

Nioc - Initial work

See also the list of contributors to this project.

This project is powered by the following components:

VueJS (MIT)
Bulma (MIT)
Buefy (MIT)
Font Awesome (Font Awesome Free License)
axios (MIT)
normalizr (MIT)
Chart.js (MIT)
vue-chartjs (MIT)
vuex-persist (MIT)
Moment.js (MIT)
vue-moment (MIT)