{"id":48518376,"url":"https://github.com/finity69x2/toggle-control-button-row","last_synced_at":"2026-04-07T20:03:11.656Z","repository":{"id":41048139,"uuid":"326033921","full_name":"finity69x2/toggle-control-button-row","owner":"finity69x2","description":"A one-button control row for any Home Assistant binary entity","archived":false,"fork":false,"pushed_at":"2023-05-11T00:29:43.000Z","size":36,"stargazers_count":12,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2023-05-11T01:23:31.964Z","etag":null,"topics":["button","home-assistant","plugin","toggle"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/finity69x2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-01T18:27:47.000Z","updated_at":"2023-05-11T01:23:31.964Z","dependencies_parsed_at":"2022-09-20T01:00:41.914Z","dependency_job_id":null,"html_url":"https://github.com/finity69x2/toggle-control-button-row","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/finity69x2/toggle-control-button-row","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finity69x2%2Ftoggle-control-button-row","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finity69x2%2Ftoggle-control-button-row/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finity69x2%2Ftoggle-control-button-row/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finity69x2%2Ftoggle-control-button-row/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/finity69x2","download_url":"https://codeload.github.com/finity69x2/toggle-control-button-row/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/finity69x2%2Ftoggle-control-button-row/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31526666,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["button","home-assistant","plugin","toggle"],"created_at":"2026-04-07T20:02:48.297Z","updated_at":"2026-04-07T20:03:11.645Z","avatar_url":"https://github.com/finity69x2.png","language":null,"readme":"# toggle-control-button-row\n\nProvides a means to program a Lovelace button row to control any binary entity (lights, switches, input booleans, etc) that have the state as either on or off using a toggle style single button. \nThis will also work for fans and dimmable lights that you would only ever like to switch on \u0026 off with a single speed or brightness setting (set outside the configuration for this plugin)\n\nInstallation:\n\nThe easiest way to install this is to use the Home Assistant Community Store (HACS) in Home Assistant.\n\nFollow the instructions there for installation making sure you note the \"url:\" section for the resources addition.\n\n\nConversely, if you don't use HACS you can install it manually by performing the following:\n\nCopy the toggle-control-button-row.js file to the appropriate folder in your Home Assistant Configuration directory (/config/www/).\n\nPlace the following in your \"resources\" section in your lovelace configuration (updating the localation to where you placed the above file):\n\n  ```\n    - url: /local/toggle-control-button-row.js\n      type: module\n  ```\n    \nThen to use this in a card place the following in your entity card:\n\n\n\u003cb\u003eOptions:\u003c/b\u003e\n\n| Name | Type | Required | Default | Description |\n| --- | --- | --- | --- | --- |\n| entity | String | Yes | none | any binary (on/off) entity_id |\n| type | String | Yes | none | custom:binary-control-button-row |\n| name | String | No | none | A custom name for the entity in the row |\n| customTheme | Boolean | No | false | set to true to use a custom theme |\n| width | String | No | 30px | A custom width for the button |\n| height | String | No | 30px | A custom height for the button |\n| isOffColor | String | No | '#f44c09' | Sets the color of the 'Off' button if entity is off |\n| isOnColor | String | No | '#43A047' | Sets the color of the 'Low' button if entity is on low |\n| customOffText | String | No | 'OFF' | Sets the text of the \"off\" button |\n| customOnText | String | No | 'ON' | Sets the text of the \"on\" button |\n| state_color | Boolean | No | false | Sets the icon color of the entity to reflect the current state |\n\nThe values for the colors can be any valid color string in \"HEX\", \"RGB\" or by color name.\n\n\u003cb\u003eConfiguration Examples:\u003c/b\u003e\n    \n  ```\n    cards:\n      - type: entities\n        title: Toggle Buttons\n        show_header_toggle: false\n        entities:\n        ## USE THIS CONFIG TO HAVE IT MATCH YOUR THEME ##\n          - type: custom:toggle-control-button-row\n            name: Basement Bath Default Button Row\n            entity: light.sengled_e11g13_03070a4c_1\n            customTheme: false\n        ## USE THIS CONFIG TO USE A DEFAULT CUSTOM THEME\n          - type: custom:toggle-control-button-row\n            name: Basement Bath Custom Button Row\n            entity: light.basement_bath_light\n            customTheme: true\n        ## USE THIS CONFIG TO USE A 'CUSTOMZED' CUSTOM THEME\n          - type: custom:toggle-control-button-row\n            name: Basement Bath Customized Button Row\n            entity: light.sengled_e11g13_03070a4c_1\n            customTheme: true\n            isOnColor: 'rgb(255, 0, 0)'\n            isOffColor: 'purple'\n        ## USE THIS CONFIG TO SET CUSTOM BUTTON TEXT (NOT REQUIRED TO SET \"customTheme: true\" TO USE THESE )\n          - type: custom:toggle-control-button-row\n            name: Basement Bath Customized Button Row\n            entity: light.sengled_e11g13_03070a4c_1\n            customOnText: yay\n            customOffText: nay\n            width: '15px'\n            height: '15px'\n            \n  ```\n\nThis is with the Slate Lovelace frontend theme set using the default colors:\n\n![Default](toggle_row_default.gif)\n\n\nThis is with the Slate Lovelace frontend theme set using the default custom theme colors:\n\n![CustomDefault](toggle_row_custom_default.gif)\n\n\nThis is with the Slate Lovelace frontend theme set using the custom theme colors (black \u0026 purple) with custom text:\n\n![CustomDefault](toggle_row_custom_text.gif)\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffinity69x2%2Ftoggle-control-button-row","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffinity69x2%2Ftoggle-control-button-row","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffinity69x2%2Ftoggle-control-button-row/lists"}