Metadata-Version: 2.4
Name: gitoon-frontend
Version: 20251229.8
Summary: The GiToon frontend
Author-email: The GiToon Authors <edgar.grig.2001@gmail.com>
License-Expression: Apache-2.0
Requires-Python: >=3.13.0
Description-Content-Type: text/markdown
License-File: LICENSE.md
Dynamic: license-file

# GiToon Frontend

## GiToon parameters for customizations

Create helper entity of type `Toggle` with name `GiToon Parameters`. Then create a file under in path `/config/customize.yaml`. Add this yaml code in that file and adjust values for parameters.

```yaml
input_boolean.gitoon_parameters:
  show_assist_button_in_topbar: false # When true, the Assist button is visible in the top bar for all users except the owner (who always sees it).
  show_search_entities_button_in_topbar: false # When true, the Search Entities button is visible in the top bar for all users except the owner (who always sees it).
  show_edit_button_in_topbar: false # When true, the Edit button is visible in the top bar for all users except the owner (who always sees it).
  show_plus_button_in_topbar: false # When true, the Plus button is visible in the top bar for all users except the owner (who always sees it).
  show_scripts_for_admins: false # When true, scripts become visible in the UI for admin users (can be hidden otherwise).
  show_scenes_for_admins: false # When true, scripts become visible in the UI for admin users (can be hidden otherwise).
  show_repair_issues_for_admins: false
  hidden_sidebar_items_for_admins: # Default value: [custom, media-browser, developer-tools]
    - custom # Addons, HACS, Hassio,
    - media-browser # Media
    - developer-tools # Developer Tools
  hidden_sidebar_items_for_users: # Default value: [custom, media-browser, developer-tools]
    - custom # Addons, HACS, Hassio,
    - media-browser # Media
    - developer-tools # Developer Tools
  show_automations_for_admins: false # When true, automations are shown in the UI for admin users.
  admin_has_maximum_visibility: false # When true, admins get full visibility of all elements (ignores individual visibility settings).
  admins_with_maximum_visibility: # - Works only if `admin_has_maximum_visibility` is set to true.  If the list is EMPTY, then ALL admins get maximum visibility. If the list contains user IDs, ONLY those admins listed here get maximum visibility.
    - 1693336839bc4133956f6989b836e501
  admin_can_edit_light_favorites: false # When admin is allowed to edit lights favorite colors and effects.
  45df7312_zigbee2mqtt: # When need to override sidebar item title.
    title: New Zigbee # Specify new title here
```

## Light entities customizations

### All this attributes are created to change light entities behaviours. They can change light entities appearances in differnt places in GiToon app.

```yaml
light.<your_entity_id>:
  send_white_color: true # When you need the dimmer to send it's color as white every time you change it's state
  use_default_color: # When you want the light entity icon to have default color (does not change icon color when changing color temperature)
    - state-badge # These are possible values of the array
    - hui-light-card
    - hui-tile-card
    - ha-state-control-light-brightness
  can_support_unknown: false
  can_support_on_off: false
  can_support_brightness: false
  can_support_color_temp: false
  can_support_hs_color: false
  can_support_xy_color: false
  can_support_rgb_color: false
  can_support_rgbw_color: false
  can_support_rgbww_color: false
  can_support_white: false
  can_support_feature_effect: false
  can_support_feature_flash: false
  can_support_feature_transition: false
  can_support_favorite_colors: false
  can_support_favorite_effects: false
```

### Also in `customize.yaml` you are able to override native attributes. For example

```yaml
light.<your_entity_id>:
  supported_color_modes:
    - brightness
```
