EventLogger

[jgab 2,647]

Please login or register to see this attachment.

HC3 Event Logger - Installation Guide

HC3 Event Logger is a desktop application for monitoring Fibaro Home Center 3 (HC3) events in real-time. It provides a clean interface to view device events, scene triggers, and system activities as they happen. It's mainly useful if you need to monitor the HC3 (system) events. Ex. if you are developing a QA using the RefreshStateSubscriber or other mechanisms.

Features:

• Real-time event monitoring with live updates
• HC3 system information viewer
• Automatic update checking and installation
• No CORS issues - native desktop app
• Fast and lightweight
• Secure local connection to your HC3

Download

Download the latest version: 

Please login or register to see this link.

Available files:

• macOS (Apple Silicon M1/M2/M3): HC3-Event-Logger_aarch64.app.tar.gz
• macOS (Intel): HC3-Event-Logger_x64.app.tar.gz
• Windows: HC3-Event-Logger_x64-setup.exe

IMPORTANT: Configure HC3 Credentials First

You must configure your HC3 credentials before using the app.

Option 1: Using a .env File (Recommended)

Create a file named .env with the following content:

Please login or register to see this code.

Replace with your actual values:

• HC3_HOST - Your HC3 IP address (no http://)
• HC3_USER - Your HC3 username (usually "admin")
• HC3_PASSWORD - Your HC3 password
• HC3_PROTOCOL - Optional, defaults to 'http'. Use 'https' if your HC3 requires it

Where to place the .env file:

macOS: Place in your home directory: ~/.env (easiest - just create it in your home folder)

Windows: Place in your user folder: C:\Users\YourUsername\.env

Quick create commands:

macOS: nano ~/.env (then paste content, Ctrl+X to save)

Windows: notepad %USERPROFILE%\.env (then paste content and save)

Option 2: Using Environment Variables

macOS/Linux:

Please login or register to see this code.

Windows (PowerShell):

Please login or register to see this code.

Installation Instructions

macOS

1. Download the appropriate file for your Mac (Apple Silicon or Intel)
2. Extract the downloaded .tar.gz file (double-click in Finder)
3. Drag hc3-event-logger.app to your Applications folder
4. Create a .env file in your home directory: ~/.env with your HC3 credentials (see above)
5. Right-click the app and select "Open" (first time only for macOS security)

macOS Security Note: If you see "cannot be opened because it is from an unidentified developer":

• Right-click the app and select "Open", or
• Go to System Preferences → Security & Privacy → Click "Open Anyway"

Windows

1. Download HC3-Event-Logger_x64-setup.exe
2. Run the installer and follow the wizard
3. Create a .env file in your user folder: C:\Users\YourUsername\.env with your credentials
4. Launch from Start Menu or desktop shortcut

Windows Security Note: If you see "Windows protected your PC":

• Click "More info"
• Click "Run anyway"

Using the App

Main Window - Event Logger

Displays real-time events from your HC3:

• Timestamp - When the event occurred
• Event Type - Type of event (device change, scene trigger, etc.)
• Source ID - Device or scene that triggered the event
• Details - Event-specific information

HC3 System Info Window

Access from Window → HC3 System Info menu to view:

• System information (version, serial number, platform)
• Z-Wave and Zigbee configuration
• Settings (timezone, temperature unit, language)
• Sun times (sunrise/sunset)
• Available updates

Automatic Updates

The app includes automatic update functionality:

• Click Window → Check for Updates... to manually check for new versions
• When an update is available, you'll see a dialog with release notes
• Click "Update" to automatically download and install the latest version
• The app will restart automatically after the update is installed
• All updates are cryptographically signed for security

Troubleshooting

App shows "Credentials Not Configured"

• Make sure you created the .env file with correct credentials
• Check the file is in the correct location (home directory for macOS: ~/.env, user folder for Windows: %USERPROFILE%\.env)
• Verify the file is named exactly .env (not .env.txt)
• Restart the application after creating/modifying .env
• Enable DevTools to see credential loading logs: Press Cmd+Shift+I (macOS) or Ctrl+Shift+I (Windows), or use Window → Toggle Developer Tools menu

Cannot connect to HC3

• Verify your HC3 IP address is correct
• Check your computer is on the same network as HC3
• Test by opening http://YOUR_HC3_IP in a browser
• Verify username and password are correct
• Click the connection status indicator to retry the connection
• Check DevTools console (Cmd/Ctrl+Shift+I) for detailed error messages

Using Developer Tools

For debugging issues, you can open the Developer Tools:

• Press Cmd+Shift+I (macOS) or Ctrl+Shift+I (Windows)
• Or select Window → Toggle Developer Tools from the menu
• The Console tab shows credential loading status and connection errors
• Look for messages about .env file location and what credentials were loaded
• Press the same shortcut again to close DevTools

Updates

• If automatic update check fails, you can always download the latest version manually from GitHub
• Updates require an internet connection to check and download
• The app will notify you when a new version is available

Security & Privacy

• Your credentials are stored locally on your computer only
• No data is sent to external servers
• The app connects directly to your HC3 on your local network
• Keep your .env file secure (same as any password file)

System Requirements

macOS: macOS 10.15 (Catalina) or later, Apple Silicon or Intel processor

Windows: Windows 10 or later, 64-bit processor

---

Support: Report issues at 

Please login or register to see this link.

GitHub: 

Please login or register to see this link.

Edited October 26, 2025 by jgab

[Łukasz997 117]

I have to say this app really hits my needs. For anyone working with events (me!), it’s fundamental to understand their structure so can be later recognized and filtered. I do have a Lua code that “grabs the event by the balls” and shows structure, but it’s hard to embed that code in every program I want to debug while also watching the events flowing into it. 
This is much easier now.
Thank you very much!

PS: Event logger does now log in when https alone is selected in HC3

[jgab 2,647]

8 minutes ago, Łukasz997 said:

I have to say this app really hits my needs. For anyone working with events (me!), it’s fundamental to understand their structure so can be later recognized and filtered. I do have a Lua code that “grabs the event by the balls” and shows structure, but it’s hard to embed that code in every program I want to debug while also watching the events flowing into it. 
This is much easier now.
Thank you very much!

PS: Event logger does now log in when https alone is selected in HC3

 

Thanks, just pushed v0.2.0 (will take some minutes to build). It has improvements, like clicking on the id to get the resource structure the id refers to - useful to understand what the id is for kind of object.

I will look into the https thing...

[jgab 2,647]

v0.2.1 has support for adding env variable

Please login or register to see this code.

It defaults to http if no set.

[awlieser 21]

Hi jgab,

 

tried with .env and export - no joy! Do I have to put the credientials within quotation marks? Thanks!

[jgab 2,647]

Do you get a green dot - connected at the top right corner? or another message? or a dialogue with some message?

No, you should not have them in quote marks.

MacOS or Windows?

I'm not a Windows person, but I know that Windows firewall may block apps. Usually it asks first time the app start but depending on settings I guess you may have to go to the firewall settings and enable the app for local access.

 

Have you setup the HC3 to only connect with https? Then you should add

Please login or register to see this code.

 

Let me know how it goes...

 

Edited October 25, 2025 by jgab

[awlieser 21]

Hi jgab, I‘m on MacOs. Will try with https.

[awlieser 21]

Hi jgab, tried both http & https - no change. Checked permissions of the .env file - they're ok (rwrr). Eventlogger is in the Programs directory and .env in my Home directory. Any idea what to try next? Thanks!

[jgab 2,647]

3 hours ago, awlieser said:

Hi jgab, tried both http & https - no change. Checked permissions of the .env file - they're ok (rwrr). Eventlogger is in the Programs directory and .env in my Home directory. Any idea what to try next? Thanks!

What does it say in the upper right corner (the connection status with a green or red dot)

[Łukasz997 117]

I see in this thread name of the program like this (screenshot from this page):

Please login or register to see this image.

/monthly_2025_10/image.png.6f89ece2804dedcde44bd7f0366ec609.png" />

Downloaded (on mac), has the following name: hc3-event-logger

Sounds naive, but maybe this is the problem...

 

[awlieser 21]

3 hours ago, jgab said:

What does it say in the upper right corner (the connection status with a green or red dot)

It shows a red dot - no credentials found ☹️

[jgab 2,647]

I have released v0.2.34 that has a "check for updates" menu item, and it will download, install and restart the app. No need to go through the song and dance to allow the new app on MacOS. However, you need to install 0.2.34 manually to get it working...😉
There is also a menu to open the developer tools panel (javascript panel) to see the console log messages.

The console log can help with issues like finding out why the .env and the credentials don't work. See the first post for instructions.

Edited October 26, 2025 by jgab

[jgab 2,647]

20 hours ago, Łukasz997 said:

I see in this thread name of the program like this (screenshot from this page):

Please login or register to see this link.

Downloaded (on mac), has the following name: hc3-event-logger

Sounds naive, but maybe this is the problem...

 

Thanks, I've updated the docs to hc3-event-logger

[awlieser 21]

2 hours ago, jgab said:

I have released v0.2.34 that has a "check for updates" menu item, and it will download, install and restart the app. No need to go through the song and dance to allow the new app on MacOS. However, you need to install 0.2.34 manually to get it working...😉
There is also a menu to open the developer tools panel (javascript panel) to see the console log messages.

The console log can help with issues like finding out why the .env and the credentials don't work. See the first post for instructions.

Hi jgab, my HC3 is at 102.168.2.109. When using the export of the variables, I still get this error "Connection failed HTTP 401"

 

I get this this from the log, so the credentials are obviously set:

 

[Log] Config from environment: (script.js, line 603)

Object

 

host: "192.168.2.109"

password: "SET"

protocol: "http"

user: "admin"

 

Object Prototype

[Log] Config loaded: (script.js, line 626)

Object

 

ip: "192.168.2.109"

password: "***"

protocol: "http"

username: "admin"

[jgab 2,647]

"401 Unauthorized

The HTTP 401 Unauthorized client error response status code indicates that a request was not successful because it lacks valid authentication credentials for the requested resource."

So, check the user/password again?
You could try adding 

Please login or register to see this code.

but I think the error code would be different (but the HC3 could still return 401...)

[awlieser 21]

Hi jgab, could it be possible that my password - which starts with a $ -sign - is mistakenly interpreted as being a variable?

[jgab 2,647]

Could be. Could you try with another password and let me know?

[awlieser 21]

Hi jgab, that did it - app now works flawlessly! Thanks!

[jgab 2,647]

If you add it in the .env file I think you should be able to have a '$' as prefix.
If you do an shell export, you need to single quote the value, or it expands to '' as $ is not set.
Like

Please login or register to see this code.

 

[Christb 33]

On 10/26/2025 at 7:12 PM, jgab said:

Please login or register to see this code.

Hi@jgab,

I have a password starting by # and I am working with Windows 10.

I have not yet been able to have the HC3 Event Logger to connect (red dot on top right☹️)

I had already a .env located in C:\Users\ASUS  root folder which has already HC3_URL, HC3_USER, HC3_PASSWORD correct lines so I have just added HC3_HOST=<HC3 ip address> and HC3_PROTOCOL=https lines. I tried also the powerSell method without success as I still have the following:

603      console.log('Config from environment:', {
                    host: config.host || 'NOT SET',
                    user: config.user || 'NOT SET',
                    password: config.password ? 'SET' : 'NOT SET',
                    protocol: config.protocol || 'NOT SET (defaults to http)'
                });

Any idea why?