HomeMap

[jgab 2,647]

I fixed ctrl-click to work on MacOS in the next release. (obscure javascript "bug" for Safari/MacOS)

[Sjakie 156]

Jan, I am lost!

As mentioned above I was busy modifying the devices in config.json>> restart and getting that error.

Path was set because I was in the floorpan before.

So I started all over again follow your instructions "HomeMap tutorial"  but there is nothing about the .env file??

Created a new .environment file with >> HC3_HOMEMAP=/Users/sjaakkoppejan/HomeMap/homemapdata

in Floorplan settings same path is in

 

still that error

[jgab 2,647]

45 minutes ago, Sjakie said:

Jan, I am lost!

As mentioned above I was busy modifying the devices in config.json>> restart and getting that error.

Path was set because I was in the floorpan before.

So I started all over again follow your instructions "HomeMap tutorial"  but there is nothing about the .env file??

Created a new .environment file with >> HC3_HOMEMAP=/Users/sjaakkoppejan/HomeMap/homemapdata

in Floorplan settings same path is in

 

still that error

Have you been in the settings menu? (the cogwheel in the upper part of the window). There is a HomeMap Data path. Make sure that it points to your map. 

If that's not set it uses the .env variable to fill it in. It may have become set to something you had in the past and points wrong.

Edited October 31, 2025 by jgab

[Sjakie 156]

Jan that I checked, double checked and triple checked, settings okay.

Struggling for hours to get rid of that error.

Eureka??

removed all  folders, files and  app

Installed version 1.4 >> seeing floor map 

update >> 1.6

Change i config.json your device example 123 in one lamp of my living room >>> save reopen Floorplan

 

error can't find homedatamap!!!!

So again installed 1.4

Afraid to update now

Please advice

 

When in 1.4 and modifying device in config.json  I get error when saving the file that I don't have the rights to do.

No clue why this is coming I only was playing with floorpan.

How to solve this?

Edited October 31, 2025 by Sjakie
no rights

[jgab 2,647]

[0.1.17] - 2025-10-31

Added

• Auto-Discover HC3 Devices: New feature to automatically discover and add HC3 devices
  • "Auto-discover" button in Edit Mode for quick device discovery
  • Fetches all devices from HC3 and suggests widget mappings
  • Shows ALL devices (both mapped and unmapped)
  • Mapped devices checked by default, unmapped devices unchecked
  • Widget Selection: Dropdown for each device to select/change widget type
  • Floor Selection: Dropdown to choose which floor to place each device
  • Device grouping by floor with smart grid positioning
  • Control buttons: "Select All", "Deselect All", "Select Mapped Only"
  • Visual indicators for unmapped devices with "Unmapped" badge
  • Success message shows devices added per floor
• Device Mapping System:
  • JSON-based mapping rules in src/deviceMappings.json
  • Automatic widget assignment based on device type, interface, and properties
  • Fallback logic for complex device types (e.g., binarySwitch with/without light interface)
  • 15 device type mappings included out of the box
• Generic Device Widget:
  • New genericdevice widget for unmapped/unknown devices
  • Static icon display with no interactions
  • Perfect for devices without specific widget support
  • Located at homemapdata/widgets/built-in/genericdevice.json
• New AutoMapManager Module: Handles device discovery, mapping, and batch addition

Changed

• HC3ApiManager: Added fetchDevices() method to retrieve all devices from HC3
• Device Format: Auto-discovered devices use correct format (type, floor_id, position)
• Button Label: Auto-discover button shortened to "Auto-discover" (no emoji) to save header space

Fixed

• Authentication: Fixed config.user vs config.username inconsistency in fetchDevices()
• Status Update: Fixed missing parameter name (status vs state) in updateStatus() method
• Syntax Error: Removed duplicate closing brace in HC3ApiManager

[jgab 2,647]

24 minutes ago, Sjakie said:

Jan that I checked, double checked and triple checked, settings okay.

Struggling for hours to get rid of that error.

Eureka??

removed all  folders, files and  app

Installed version 1.4 >> seeing floor map 

update >> 1.6

Change i config.json your device example 123 in one lamp of my living room >>> save reopen Floorplan

 

error can't find homedatamap!!!!

So again installed 1.4

Afraid to update now

Please advice

 

When in 1.4 and modifying device in config.json  I get error when saving the file that I don't have the rights to do.

No clue why this is coming I only was playing with floorpan.

How to solve this?

 

Where have you stored your homemapdata folder? Seems to be some MacOS folder protection mechanism in play?

1. Go to System Settings (or System Preferences) > Privacy & Security. 

2. Click the lock icon and enter your administrator password to make changes. 

3. Scroll down to Full Disk Access and click on it. 

4. In the list, find the application you're using and check the box next to it. 

5. If the application isn't listed, click the + button to add it from your Applications folder. 

6. You may need to click "Quit & Open" to confirm the changes. 

In 0.1.17 that I just released there is an "auto-discover" function when edit is selected. It auto-maps your HC3 devices with a list where you can fine-tune the mappings.
It also fixes ctrl-click on MacOS.

[Sjakie 156]

Jan I see stuff on my Macbook I never have seen before!

Permission set as you pointed and homemap permission given

Wierd yesterday all was working fine.

Both in settings and .env>> HC3_HOMEMAP=/Users/sjaakkoppejan/HomeMap/homemapdata

I removed again all HomMap stuff.

Installed version version Light icon is not according your icons! That's why I did't see the icon in my floor mason a gray back ground.

Now again version  1.4 and your floor map is visible change device >>ok

Update latest version >>error can't find homedatamap

So back to ......

 

[jgab 2,647]

3 minutes ago, Sjakie said:

Jan I see stuff on my Macbook I never have seen before!

Permission set as you pointed and homemap permission given

Wierd yesterday all was working fine.

Both in settings and .env>> HC3_HOMEMAP=/Users/sjaakkoppejan/HomeMap/homemapdata

I removed again all HomMap stuff.

Installed version version Light icon is not according your icons! That's why I did't see the icon in my floor mason a gray back ground.

Now again version  1.4 and your floor map is visible change device >>ok

Update latest version >>error can't find homedatamap

So back to ......

 

could it be that update resets the permissions for the app?

[Sjakie 156]

nope permissions Homeapp are still full acces

version 1.4

See the strange? icon of the light.

 

Please login or register to see this attachment.

Edited October 31, 2025 by Sjakie

[jgab 2,647]

27 minutes ago, Sjakie said:

nope permissions Homeapp are still full acces

version 1.4

See the strange? icon of the light.

 

Please login or register to see this attachment.

So 1.4 is pretty old now and have bugs....

Where have you stored the homemapdata folder?

[Sjakie 156]

I know 1.4 is old but it does't give me an error just to try.

/User/user_name/HomeMap/homemapdata

 

1.5 works too if update to 1.7 again error

HomeMap still full access

Used the same folder

 

Installed 1.6 >>> updated 1.7 and it works!!! No clue what caused this hassle.

btw can we scale up some icons?

Thanks Jan for your excellent floor plan and your support!

Edited October 31, 2025 by Sjakie
1.7

[Sjakie 156]

Jan, are there coming more icon such as curtains?

[jgab 2,647]

[0.1.19] - 2025-10-31

Added

• Floor Management System:

  • Add/Edit/Delete floors via UI - no manual config.json editing needed
  • Native file picker for selecting floor plan images
  • Image preview with automatic dimension detection
  • Aspect ratio locking with checkbox for maintaining proportions
  • Floor reordering with Move Up/Down buttons
  • Right-click context menu on floor backgrounds
  • [+] tab in Edit Mode to quickly add new floors
  • Images automatically organized in floors/<floor-id>/ directories
  • Full validation (prevents deleting floors with devices)

• Device Management Panel:

  • Unified side panel for managing all devices
  • Immediate Install/Uninstall actions per device (no batch save needed)
  • Edit device properties with pen icon (✏️) button
  • Compact status badge: green "✓" for installed devices
  • Widget and floor selection enabled for uninstalled devices (configure before installing)
  • Visual highlighting for installed devices
  • Seamless integration with existing edit workflow

• House Configuration in Settings:

  • House Name field - updates window title and header
  • House Icon field - emoji input for branding (max 2 characters)
  • No more manual config.json editing for basic configuration
  • Changes apply immediately and update UI

• Auto-Managed homemapdata Folder:

  • Automatic creation in app-specific storage (~/Library/Application Support/HomeMap/homemapdata on macOS)
  • Auto-populated from homemapdata.example template on first launch
  • Includes all built-in widgets, icons, and example floor plans
  • Path visible and configurable in Settings dialog
  • Advanced users can browse to use custom folder location
  • Removed dependency on HC3_HOMEMAP environment variable

• Auto-Sync Built-in Resources:

  • Automatically syncs widgets/built-in/ on every app startup
  • Automatically syncs icons/built-in/ on every app startup
  • Ensures users always have latest widget definitions and icon sets
  • User packages (widgets/packages/, icons/packages/) remain untouched
  • Development mode detection - skips sync for project's homemapdata folder

Changed

• Settings Dialog: Added House Name and House Icon fields in Configuration section
• Floor Loading: Now uses read_image_as_base64 Tauri command for consistent image handling
• Initial Setup: Much simpler for new users - app creates everything needed automatically
• Update Process: Built-in widgets and icons update automatically with new app versions

Fixed

• Dialog Scrolling: Added max-height: 90vh and overflow-y: auto to .slider-content for long dialogs
• Floor Image Preview: Fixed loading of current floor image in Edit Floor dialog using correct path resolution
• Aspect Ratio Text: Fixed checkbox label wrapping with white-space: nowrap
• Settings Save: Fixed save_config command parameters (filePath and content instead of configPath and config)

Technical

• New Module: floorManagementDialog.js (485 lines) - Complete floor CRUD operations
• Enhanced: deviceManagementView.js - Refactored to immediate-action model
• Backend: Rust functions for template discovery, recursive directory copying, and built-in sync
• Template Bundling: homemapdata.example included in app resources for distribution

Edited October 31, 2025 by jgab

[jgab 2,647]

 

 

36 minutes ago, Sjakie said:

Jan, are there coming more icon such as curtains?

widgets, yes. 
But I was also hoping for other people to creates such widgets. I don't have curtains myself so it's a bit cumbersome to test and make sure they work.

36 minutes ago, Sjakie said:

 

Try 0.1.19, it's kind of a new start. You add floorplans in edit mode, and you open the device manager (also in edit mode) to add devices from the HC3.
There should be no need to edit the config files.
Also set the credentials in the settings menu (cogwheel)

 

Edited October 31, 2025 by jgab

[jgab 2,647]

So, starting with 0.1.19 the data folder is created at startup if it doesn't exist. It usually creates it in an app specific place. You can see in settings and the folder path where it is.
If you want to go in and hack the files, there it is. You can also copy the folder to another place and set the path to point to that position. This way you can have a special version for development, and another for "production"
In principle you should not need to go into config files manually. The Editor allows to create and manage floors, and a Device manager to manage devices.

If you want to add your own icons and widgets, you have to go into the folder manually now. (In the future there may be some UI support for that too)

 

If you already have an old folder you should be able to set the path to it in settings and folder path. But I would recommend to start afresh.

[jgab 2,647]

v0.1.20 pushed. There was some bugs when deleting a device from the map

[Brors94 115]

23 hours ago, jgab said:

 

Yes, to present a list of current device on the HC3 is in my mind, but if you have a lot of devices the dropdown list becomes long....
 

It's per year.

How's the structure of your homemapdata folder? especially the widgets/*

@jgab 

Wow, you have been working today  
The auto pop of devices is Nice!
I search function would be amazing xD as you pointed out if people have alot of devices 😅

Edit:
after some "adding devices" I see we still need the right click or a search function to add devices and not just the auto populate  (ill do it the json way for now so no worries  ) 

Edited October 31, 2025 by Brors94

[Christb 33]

 

Please login or register to see this link.

(edited) by Jgab

You could create your own version of the light widget (light.json) and make it point to your own icons.
You could also, if you have a smaller floor plan, zoom in to make the icons larger relative to the floorplan.
A future version will allow you to add widget parameters to a device definition, so you could tell the built-in light widget to use your own icon set...
But this is the wrong forum thread for HomeMap discussion  

_________________________________________________________________________________________________________________________________________________________

Thank you  and I will try to do my own widget

[jgab 2,647]

For Windows the latest versions of Windows have an issue with initialising the data folder. 
Im also away on a trip and will not have full cpu power until after the weekend.

[Sjakie 156]

Jan, possible to create sort button name, room or number? Hide unmapped?

I have 427 devices so to search is difficult.

If for devices select light it was visible but later I need to change in light color to see it back

Thanks in advance

Edited October 31, 2025 by Sjakie
light