TapHome Icon Mapping Documentation#

Overview#

This document provides a comprehensive mapping between SVG icon files found in /app-icons folder and TapHome enum values (DeviceType, ValueLogType, TriggerType, and VectorIconType).

Total Icons Analyzed: 805 SVG files

Table of Contents#

1. Icon File Statistics
2. DeviceType Icon Mappings
3. ValueLogType Icon Mappings
4. TriggerType Icon Mappings
5. Icon Naming Patterns
6. Unmatched Enums
7. Icon Categories

Icon File Statistics#

DeviceType Icon Mappings#

Total Matches: 137 icon files → 45 DeviceType enum values

High Confidence Matches (101 icons)#

Direct name matches or clear device type indicators.

Medium Confidence Matches (33 icons)#

Reasonable associations with some ambiguity.

ValueLogType Icon Mappings#

Total Matches: 99 icon files → 51 ValueLogType enum values

High Confidence Matches (67 icons)#

Direct name matches or clear semantic relationships.

Medium Confidence Matches (24 icons)#

Likely matches with reasonable associations.

TriggerType Icon Mappings#

Total Matches: 66 icon files → 37 TriggerType enum values

High Confidence Matches (48 icons)#

Icons with sr_ prefix (Smart Rule) provide the most reliable matches.

Medium Confidence Matches (18 icons)#

State-based icons and functional icons.

Icon Naming Patterns#

Pattern Categories#

1. Smart Rule Icons (sr_ prefix)#

Pattern: sr_[function].svg

Examples:

• sr_alarm.svg → AlarmTriggered
• sr_motion.svg → MotionDetected
• sr_window.svg → WindowOpened
• sr_thermostat.svg → ThermostatModeChanged
• sr_script.svg → ScriptEvaluation

Count: ~40 icons Purpose: Smart Rule automation triggers

2. State Indicators (-state suffix)#

Pattern: [device/value]-state.svg

Examples:

• alarm-state.svg → Alarm device state
• motion-state.svg → Motion sensor state
• flood-state.svg → Flood sensor state
• locked-state.svg → Lock state
• fire-state.svg → Smoke sensor state

Count: ~66 icons Purpose: Device and sensor state indicators

3. Level Indicators (-level suffix)#

Pattern: [device/control]-level.svg

Examples:

• pump-level.svg → Pump level control
• valve-level.svg → Valve position level
• floorLamp-level.svg → Lamp dimming level
• heating-level.svg → Heating level
• poolLight-level.svg → Pool light level

Count: ~40 icons Purpose: Device level/intensity controls

4. Symbol Icons (symbol- prefix)#

Pattern: symbol-[name].svg

Examples:

• symbol-temperature.svg → Temperature measurement
• symbol-humidity.svg → Humidity measurement
• symbol-battery.svg → Battery level
• symbol-brightness.svg → Brightness measurement
• symbol-co2.svg → CO2 measurement

Count: ~468 icons Purpose: UI symbols and value type indicators

5. Device Type Icons#

Pattern: [devicename].svg or [devicename]-state.svg

Examples:

• alarm.svg → Alarm device
• boiler.svg → Boiler device
• thermostat.svg → Thermostat device
• weather.svg → Weather station
• irrigation-state.svg → Irrigation system

Count: ~137 icons Purpose: Device type identification

6. Detail Icons (detail- prefix)#

Pattern: detail-[component]-[property].svg

Examples:

• detail-thermostat-level-angle.svg → Thermostat detail
• detail-blind90-level-angle.svg → Blind control detail
• detail-awning-level.svg → Awning control detail
• detail-analogOutput-level.svg → Analog output detail

Count: ~15 icons Purpose: Detailed UI components for specific controls

7. Button Icons (button_ prefix)#

Pattern: button_[action].svg

Examples:

• button_plus.svg → Add button
• button_minus.svg → Remove button
• button_edit.svg → Edit button
• button_delete.svg → Delete button
• button_search.svg → Search button

Count: ~50 icons Purpose: UI action buttons

8. Circle Icons (circle- prefix)#

Pattern: circle-[name].svg

Examples:

• circle-devices.svg → Devices menu
• circle-setting.svg → Settings menu
• circle-chart.svg → Chart view
• circle-user.svg → User profile
• circle-location.svg → Location

Count: ~20 icons Purpose: Circular navigation icons

9. Large Icons (large_ prefix)#

Pattern: large_[name].svg

Examples:

• large_light1.svg → Large light icon
• large_camera.svg → Large camera icon
• large_door.svg → Large door icon
• large_loudspeaker.svg → Large speaker icon
• large_switch.svg → Large switch icon

Count: ~10 icons Purpose: Oversized UI variants

10. Meter/Symbol Icons (Symbol/Meter suffix)#

Pattern: Symbol[Type]Meter.svg or [Type]Meter[Variant].svg

Examples:

• SymbolElectricMeter.svg → Electric meter symbol
• SymbolGasMeter.svg → Gas meter symbol
• SymbolWaterMeter.svg → Water meter symbol
• WaterMeterGroup.svg → Water meter group
• electricMeter-impulse.svg → Electric meter impulse

Count: ~20 icons Purpose: Metering device icons

11. Type Variants#

Pattern: [device]-[type]-[property].svg

Examples:

• lightBulb-led-state.svg → LED bulb state
• lightBulb-halogen-level.svg → Halogen bulb level
• valve-hot-level.svg → Hot valve level
• valve-cold-state.svg → Cold valve state
• pump-heating-level.svg → Heating pump level

Count: ~30 icons Purpose: Device type-specific variants

12. Step Control Icons (-step suffix)#

Pattern: [control][number]-step.svg

Examples:

• fan3-step.svg → 3-speed fan control
• fan4-step.svg → 4-speed fan control
• intensity3-step.svg → 3-level intensity
• signal2-step.svg → 2-step signal

Count: ~15 icons Purpose: Multi-step control indicators

Unmatched Enums#

DeviceType (81 unmatched)#

These DeviceType enum values don’t have corresponding icon files:

• Sensors: TemperatureSensor, HumiditySensor, PressureSensor, LightSensor, DistanceSensor, UVSensor, SoundSensor, AirQualitySensor
• Contacts: DoorContact, ContactSensor, ReedSwitch, VibrationSensor
• Switches/Relays: Relay, WallSwitch, VirtualSwitch
• Climate: Humidifier, Dehumidifier, AirConditioner, InfraredHeater, EvaporativeCooler
• Covers: ElectricCurtains, Curtains, WindowOpener, Gate
• Appliances: Oven, Fridge, Freezer, WashingMachine, Dishwasher, Dryer, Cooktop, Hood, Microwave, Kettle
• Other: Projector, Stove, Barbecue, PetFeeder, RobotMower, LawnMower, Diffuser, WaterHeater, WiFi, WiFiRouter
• Controllers: RoomController, KeyPad, WallController, MultiFunctionController
• Buttons: Button, VirtualButton, Input
• Energy: SolarPanel, Inverter, HeatMeter, FlowMeter
• Heating: HeatPump, Fireplace, OutdoorHeater
• Ventilation: HRVUnit
• Security: GlassBreakSensor, Siren
• Multi-function: MultiFunctionSensor, GenericSensor, SmartRuleTrigger
• Remaining indicators: CO2Remaining, VOCRemaining, PM25Remaining, PM10Remaining, FilterRemaining

Likely Reasons:

• These devices use generic icons from VectorIconType enum
• UI renders them with symbol icons instead of device-specific SVGs
• Icons may be generated programmatically
• Some devices are rarely used or deprecated

ValueLogType (54 unmatched)#

These ValueLogType enum values don’t have corresponding icon files:

• Electrical Multi-phase: PowerL1, PowerL2, PowerL3, VoltageL1, VoltageL2, VoltageL3, CurrentL1, CurrentL2, CurrentL3, PowerFactorL1, PowerFactorL2, PowerFactorL3
• Reactive Power: ReactivePower, ReactiveEnergy, ApparentPower, ApparentEnergy
• Advanced Air Quality: Radon, O2, O3, NO2, SO2, CH4, H2, NH3, Benzene, Toluene, FormaldehideCH2O, ParticulateMatter, AirQualityIndex
• Pool Chemistry: ORP, ChlorineLevel, TotalHardness, CalciumHardness, Alkalinity, Conductivity
• Weather Extended: UVIndex, WindDirection, DewPoint, HeatIndex, WindChill, FeltTemperature
• Temperatures: InletTemperature, OutletTemperature, ReturnTemperature
• Physical: Force, Torque, Energy, Depth, Height, Distance, Rotation, Speed, Flow
• Consumption Totals: TotalConsumption, TotalGasConsumption, TotalHeatConsumption, TotalWaterConsumption, HeatConsumption
• Other: PowerFactor, Frequency, RSSI, Volume

Likely Reasons:

• Complex multi-phase electrical values use generic electrical icons
• Specialized air quality measurements use generic sensor icons
• Pool chemistry values use pH or water-related generic icons
• Some values are calculated/derived and don’t need dedicated icons

TriggerType (10 unmatched)#

These TriggerType enum values don’t have corresponding icon files:

• Opposite States: AlarmDisarmed, WindowClosed, DoorClosed, LockUnlocked, LightTurnedOff, BlindsClosed
• Humidity: HumidityHigh, HumidityLow
• Location: GeofenceExit
• Button: ButtonHeld

Likely Reasons:

• Opposite state triggers use the same icon as their counterpart (e.g., WindowOpened icon used for WindowClosed)
• ButtonHeld uses the same icon as ButtonPressed
• GeofenceExit uses the same icon as GeofenceEnter
• Humidity triggers use generic humidity icon

Icon Categories#

1. Device-Specific Icons (~137 icons)#

Icons representing physical devices and their states.

Subcategories:

• Lighting: light, lamp, bulb variants
• HVAC: heating, cooling, ventilation, thermostats
• Security: alarms, sensors, locks, cameras
• Metering: electricity, water, gas meters
• Appliances: coffee, pool equipment
• Covers: blinds, awnings, garage doors
• Valves & Pumps: various valve and pump types

2. UI Symbol Icons (~468 icons)#

Icons for user interface elements and measurements.

Subcategories:

• Measurements: temperature, humidity, pressure, etc.
• Navigation: arrows, directions, locations
• Actions: settings, edit, delete, add
• States: locked, unlocked, on, off
• Weather: rain, wind, clouds, sun
• Zones: rooms, areas (attic, balcony, cellar, etc.)

3. Smart Rule Icons (~40 icons)#

Icons specifically for automation rules.

Prefix: sr_

Types:

• Triggers: alarm, motion, window, push
• Schedules: daily, weekly, sunrise/sunset
• Controls: blinds, dimmer, thermostat
• Protection: overheat, wind protection
• Logic: equation, formula, script
• Notifications: error, general

4. Button Icons (~50 icons)#

UI action buttons.

Prefix: button_

Types:

• Navigation: back, next, previous, up, down
• Actions: add, delete, edit, save, close
• Selection: select, checkbox, starred
• Media: play, pause, microphone, photo
• View: refresh, search, menu, more

5. Circle Icons (~20 icons)#

Circular navigation and menu icons.

Prefix: circle-

Types:

• Navigation: devices, chart, list, shortcuts
• Settings: setting, terminal, wizard
• User: user, location
• Widgets: widget, widget_small

6. State Indicator Icons (~66 icons)#

Icons showing device or value states.

Suffix: -state

Examples:

• Device states: alarm-state, motion-state, flood-state
• Value states: brightness-state, temperature-state
• Control states: locked-state, powerButton-state

7. Level Control Icons (~40 icons)#

Icons for level/intensity controls.

Suffix: -level

Examples:

• Lighting levels: floorLamp-level, wallLight-level
• HVAC levels: heating-level, cooling-level
• Position levels: valve-level, blind-level

8. Detail Component Icons (~15 icons)#

Detailed UI components for specific controls.

Prefix: detail-

Examples:

• Thermostat: detail-thermostat-level-angle
• Blinds: detail-blind90-level-angle, detail-blind180-level-angle
• Valves: detail-mix-valve-cold-level
• Awning: detail-awning-level

9. Large/Oversized Icons (~10 icons)#

Oversized variants for prominent display.

Prefix: large_

Examples:

• large_light1, large_light2
• large_camera
• large_door
• large_loudspeaker
• large_switch

10. Overlay Icons (~6 icons)#

Overlay indicators for additional information.

Prefix: overlay-

Examples:

• overlay-locked, overlay-unlocked
• overlay-group
• overlay-impulse
• overlay-money
• overlay-switch

11. Number/Step Icons (~35 icons)#

Numbered state indicators and step controls.

Patterns: number[0-20]-state.svg, [control][3-8]-step.svg

Examples:

• States: number0-state through number20-state
• Fan steps: fan3-step, fan4-step
• Intensity steps: intensity3-step through intensity8-step
• Signal steps: signal1-step, signal2-step, signal3-step

12. Meter Icons (~20 icons)#

Metering and measurement device icons.

Patterns: Symbol[Type]Meter.svg, [Type]Meter[Variant].svg

Examples:

• Electric: SymbolElectricMeter, electricMeter-group, electricMeter-impulse
• Gas: SymbolGasMeter, GasMeterGroup, GasMeterImpulse
• Water: SymbolWaterMeter, WaterMeterGroup, WaterMeterImpulse
• General: SymbolMeter, SymbolAmpereMeter, SymbolVoltmeter

13. Access Control Icons (~10 icons)#

Icons for access control and security.

Prefix: access-

Examples:

• access-card
• access-PIN
• access-PINcard
• access-checkin
• access-checkout
• access-expired
• access-lost
• access-repeated

14. Scene Icons (~8 icons)#

Scene and mode indicators.

Patterns: scene[0-9]of9.svg, [mode]-state.svg

Examples:

• Scenes: scene0of9, scene1of9, scene5of9, scene9of9
• Modes: day-state, night-state, home-state, away-state
• Events: party-state, holiday-state, vacation-state

Usage Recommendations#

For DeviceType Mapping#

1. Primary Icon Selection:

   • Use device-specific icons when available (e.g., alarm.svg for Alarm)
   • Fall back to state icons for device states (e.g., alarm-state.svg)
   • Use symbol icons from VectorIconType enum for unmatched devices

2. Icon Variants:

   • Use -state suffix for on/off or discrete states
   • Use -level suffix for continuous controls (dimming, position)
   • Use type-specific icons when device has subtypes (e.g., LED, halogen, fluorescent bulbs)

3. Multiple Icons:

   • Some devices have multiple icon variants (e.g., pumps have heating, cooling, heating-cooling)
   • Select appropriate variant based on device configuration or mode

For ValueLogType Mapping#

1. Measurement Icons:

   • Prefer symbol-[name].svg for measurement displays
   • Use specialized temperature icons for different temperature types (dew, mixed, return, source)
   • Use meter icons (SymbolXXXMeter) for cumulative measurements

2. State vs Value:

   • Use -state suffix icons for binary/boolean values (detected/not detected)
   • Use measurement symbols for numeric values

3. Unit Display:

   • Icons don’t include units - display units separately in UI
   • Use auto-prefix system for large values (k, M, G)

For TriggerType Mapping#

1. Smart Rule Icons:

   • Always prefer sr_ prefix icons for Smart Rule triggers
   • These are specifically designed for automation contexts

2. Generic Triggers:

   • DeviceValueChange → sr_multiValue_trigger.svg
   • DeviceStateChange → sr_switch_trigger.svg
   • LogicCondition → sr_equation.svg or sr_formula.svg

3. Opposite States:

   • For unmatched opposite states (e.g., WindowClosed), use the same icon as the matched state
   • Indicate state difference through color or overlay

Icon Size Guidelines#

• Large icons (large_*): Use for main device representation in detail views
• Standard icons: Use for lists, cards, and general UI
• Circle icons (circle-*): Use for navigation menus and tabs
• Button icons (button_*): Use for action buttons and controls
• Symbol icons (symbol-*): Use for labels, measurements, and indicators

Color and Theming#

Icons are provided as SVG files which support:

• Dynamic color theming
• Accent color application
• State-based coloring (on/off, active/inactive)
• Overlay composition

Recommended color usage:

• Active state: Accent color (Pink, Blue, Green)
• Inactive state: Gray or muted color
• Error state: Red
• Warning state: Orange/Yellow
• Success state: Green

File References#

Source Documentation#

• Enum Reference: /Users/martinkalis/Claude/taphome_git_lfs/TAPHOME_ENUMS_AND_ICONS_REFERENCE.md
• Script Language Docs: /Users/martinkalis/Claude/taphome_git_lfs/TAPHOME_SCRIPT_LANGUAGE_DOCUMENTATION.md

Icon Folder#

• Location: /Users/martinkalis/Claude/taphome_git_lfs/app-icons/
• Total Files: 805 SVG icons
• Format: SVG (Scalable Vector Graphics)

Code Files#

• DeviceType: TapHome.Core.Lib.Model/DeviceBase.cs:149-325
• ValueLogType: TapHome.Core.Lib.Model/ValueLog.cs:12-134
• TriggerType: TapHome.Core.Lib.Model/IFTTT/TriggerType.cs
• VectorIconType: TapHome.Core.Lib.Model/VectorIconType.cs

Statistics Summary#

DeviceType Icon Mapping#

• Total DeviceType enums: 126
• Matched with icons: 45 (36%)
• High confidence matches: 101 icon files
• Medium confidence matches: 33 icon files
• Low confidence matches: 3 icon files
• Total icon-to-device mappings: 137

ValueLogType Icon Mapping#

• Total ValueLogType enums: 105
• Matched with icons: 51 (49%)
• High confidence matches: 67 icon files
• Medium confidence matches: 24 icon files
• Low confidence matches: 8 icon files
• Total icon-to-value mappings: 99

TriggerType Icon Mapping#

• Total TriggerType enums: 47
• Matched with icons: 37 (79%)
• High confidence matches: 48 icon files
• Medium confidence matches: 18 icon files
• Total icon-to-trigger mappings: 66

Overall Icon Usage#

• Total SVG icons: 805
• Mapped to enums: ~302 (38%)
• UI elements (unmapped): ~503 (62%)
• Icon categories: 14 distinct categories

Version Information#

• Document Version: 1.0
• Analysis Date: 2025-11-15
• Icon Folder: /app-icons
• Total Icons Analyzed: 805 SVG files

This documentation was generated by analyzing icon file names and matching them to TapHome enum values based on naming patterns and semantic relationships.