Search the Community

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: https://github.com/jangabrielsson/EventLogger/releases/latest 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: HC3_HOST=192.168.1.57 HC3_USER=admin HC3_PASSWORD=yourpassword HC3_PROTOCOL=http 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: export HC3_HOST=192.168.1.57 export HC3_USER=admin export HC3_PASSWORD=yourpassword export HC3_PROTOCOL=http open /Applications/hc3-event-logger.app Windows (PowerShell): $env:HC3_HOST="192.168.1.57" $env:HC3_USER="admin" $env:HC3_PASSWORD="yourpassword" $env:HC3_PROTOCOL="http" Start-Process "C:\Program Files\hc3-event-logger\hc3-event-logger.exe" Installation Instructions macOS Download the appropriate file for your Mac (Apple Silicon or Intel) Extract the downloaded .tar.gz file (double-click in Finder) Drag hc3-event-logger.app to your Applications folder Create a .env file in your home directory: ~/.env with your HC3 credentials (see above) 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 Download HC3-Event-Logger_x64-setup.exe Run the installer and follow the wizard Create a .env file in your user folder: C:\Users\YourUsername\.env with your credentials 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 github.com/jangabrielsson/EventLogger/issues GitHub: github.com/jangabrielsson/EventLogger