{"id":14986003,"url":"https://github.com/esphome/build-action","last_synced_at":"2025-08-22T08:31:24.582Z","repository":{"id":38624251,"uuid":"429375811","full_name":"esphome/build-action","owner":"esphome","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-05T22:03:59.000Z","size":109,"stargazers_count":15,"open_issues_count":2,"forks_count":12,"subscribers_count":6,"default_branch":"main","last_synced_at":"2024-12-09T04:21:40.344Z","etag":null,"topics":["actions","github-actions"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/esphome.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-18T09:51:09.000Z","updated_at":"2024-12-05T22:03:27.000Z","dependencies_parsed_at":"2024-02-28T05:26:44.272Z","dependency_job_id":"b613ae46-cee7-44fb-afb2-136858c98c5f","html_url":"https://github.com/esphome/build-action","commit_stats":{"total_commits":81,"total_committers":6,"mean_commits":13.5,"dds":0.2716049382716049,"last_synced_commit":"e6341fc6c5fdad61c9c1a06566857cfd4dca1bb1"},"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esphome%2Fbuild-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esphome%2Fbuild-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esphome%2Fbuild-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esphome%2Fbuild-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/esphome","download_url":"https://codeload.github.com/esphome/build-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230575851,"owners_count":18247484,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["actions","github-actions"],"created_at":"2024-09-24T14:12:07.215Z","updated_at":"2025-08-22T08:31:24.571Z","avatar_url":"https://github.com/esphome.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ESPHome Build action\n\n![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/esphome/build-action)\n\nThis action takes a yaml file for an ESPHome device and will compile and output\nthe build firmware file and a partial `manifest.json` file that can be used to flash\na device via [ESP Web Tools](https://esphome.github.io/esp-web-tools).\n\n## Example usage\n\n```yaml\nuses: esphome/build-action@v6\nwith:\n  yaml-file: my_configuration.yaml\n```\n\nThis action is used by the [ESPHome publish workflow](https://github.com/esphome/workflows/blob/main/.github/workflows/publish.yml) that is used to compile firmware and publish simple GitHub pages sites for projects.\n\n## Inputs\n\n| Name                | Default  | Description                                                                             |\n| ------------------- | -------- | --------------------------------------------------------------------------------------- |\n| `yaml-file`         | _None_   | The YAML file to be compiled.                                                           |\n| `version`           | `latest` | The ESPHome version to build using.                                                     |\n| `release-summary`   | _None_   | A small summary of the release that will be added to the manifest file.                 |\n| `release-url`       | _None_   | A URL to the release page that will be added to the manifest file.                      |\n| `complete-manifest` | `false`  | Whether to output a complete manifest file. Defaults to output a partial manifest only. |\n\n## Outputs\n\n| Name              | Description                                                                       |\n| ----------------- | --------------------------------------------------------------------------------- |\n| `name`            | The name of the device in yaml with the platform (eg. ESP32 or ESP8266) appended. |\n| `version`         | The ESPHome version used during build.                                            |\n| `original-name`   | The original name of the device in yaml.                                          |\n| `project-name`    | The name of the project in yaml. `esphome.project.name`                           |\n| `project-version` | The version of the project in yaml. `esphome.project.version`                     |\n\n## Output files\n\nThis action will output a folder named with the output `name` and will contain three files:\n\n- `manifest.json` \n  - If `complete-manifest` is set to `true` then this file is directly usable by esp-web-tools.\n  - Otherwise, this goes into the `builds` section of an esp-web-tools manifest.json.\n- `{name}.factory.bin` - The firmware to be flashed with esp-web-tools.\n- `{name}.ota.bin` - The firmware that can be flashed over-the-air to the device using the [Managed Updated via HTTP Request](https://esphome.io/components/update/http_request).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesphome%2Fbuild-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesphome%2Fbuild-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesphome%2Fbuild-action/lists"}