LoxBuddy

LoxBuddy is a modern and fast (Web)App to control your Loxone and LoxBerry based Smart Home. The user interface is optimized for mobile and tablet usage.

LoxBuddy establishes a WebSocket connection to your Miniserver to control and monitor the state of the available controls. In addition, LoxBuddy can interface with LoxBerry using MQTT.

WARNING: The LoxBuddy App is in early developement, thus unstable and incomplete, and may impact the stability of your Smart Home. Use it at your own risk.

Main features

• Fast, responsive, and consistent user interface
• Layout optimized for smart phone and tablet usage
• Direct installation as Progressive Web App (PWA)
• 30+ controls (switch, pulse, IRC, lighting, etc.)
• Unique LoxBuddy controls
• Lock screen with time and weather info
• 20+ themes / color palettes
• Light / Dark mode
• Independent icons
• VoIP / SIP client to communicate with intercom
• Weather forecast (using LoxBerry Weather4Lox)

Visit the Status page for the latest updates on supported features and controls.

Screenshots

More screenshots and themes

LIVE Demo

Interested to see the LoxBuddy App in action? Visit loxbuddy.nl and click Start Demo on the Login page.

Deployment using Docker (recommended)

To deploy LoxBuddy in a Docker container, make sure you have Docker Desktop installed on your system, and execute the following commands:

docker build -t loxbuddy .
docker run -p 3000:3000 loxbuddy

You can now access LoxBuddy by navigating to http://localhost:3000 in a web browser.

Deployment using the Node.js process manager (pm2)

Mke sure you have pm2 installed globally on your system:

npm install pm2 -g      # global installation only required once

You can now start, restart, stop, etc. the LoxBuddy App using one of the following pm2 commands:

npm run pm2:start       # Build and start LoxBuddy App
npm run pm2:restart     # Rebuild and restart LoxBuddy App
nom run pm2:stop        # stop LoxBuddy App, but keep associated pm2 process
npm run pm2:delete      # stop LoxBuddy App and delete associated pm2 process
npm run pm2:kill        # stop LoxBuddy App, kill all running pm2 processes
npm run pm2:list        # list all pm2 processes
npm run pm2:logs        # show logs for all pm2 processes
npm run pm2:status      # show status of all pm2 processes

After (re)starting, you can access the LoxBuddy App by navigating to http://localhost:4004 in a web browser.

Development environment

To help in the development of this App, you need a Node.js installation on your desktop. Requirement is Node.js ≥ v22.20.0 (LTS). The LoxBuddy application is based on Svelte, SvelteKit and Skeleton.

# install
git clone https://github.com/nufke/loxbuddy.git
cd loxbuddy
npm install

# update environment variables (for debug only)
cp .env.example .env.local
code .env.local

# launch development server
npm run dev

You can access LoxBuddy by navigating to http://localhost:5173 in a web browser.

Issues and requests

Please submit your issues or requests via the GitHub issue tracker or submit a pull request.

Credits

Special thanks and credits to:

• Svelte team
• Skeleton team
• Iconify team
• iro.js of James Daniel
• Svelty Picker of Martin Skočík
• Meteocons of Bas Milius

Disclaimer

Although the developer followed the official documentation, use this application at your own risk.

Buy Me A Coffee

Interested in supporting the development of this App?