{"id":26042556,"url":"https://github.com/digitallyrefined/ha-cloudflare-speed-test","last_synced_at":"2026-03-14T13:52:44.963Z","repository":{"id":280894763,"uuid":"943528465","full_name":"DigitallyRefined/ha-cloudflare-speed-test","owner":"DigitallyRefined","description":"Cloudflare Speed Test for Home Assistant","archived":false,"fork":false,"pushed_at":"2025-09-19T08:49:56.000Z","size":152,"stargazers_count":17,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-19T10:41:53.159Z","etag":null,"topics":["cloudflare","hacs-integration","home-assistant","speed-test"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DigitallyRefined.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","license":"LICENSE.txt","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"liberapay":"DigitallyRefined"}},"created_at":"2025-03-05T21:15:49.000Z","updated_at":"2025-09-19T08:29:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"69794740-6de7-4322-9449-aad39ed2e36d","html_url":"https://github.com/DigitallyRefined/ha-cloudflare-speed-test","commit_stats":null,"previous_names":["digitallyrefined/ha-cloudflare-speed-test"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/DigitallyRefined/ha-cloudflare-speed-test","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-cloudflare-speed-test","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-cloudflare-speed-test/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-cloudflare-speed-test/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-cloudflare-speed-test/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DigitallyRefined","download_url":"https://codeload.github.com/DigitallyRefined/ha-cloudflare-speed-test/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DigitallyRefined%2Fha-cloudflare-speed-test/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279016562,"owners_count":26085850,"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","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cloudflare","hacs-integration","home-assistant","speed-test"],"created_at":"2025-03-07T16:32:57.593Z","updated_at":"2026-03-14T13:52:44.956Z","avatar_url":"https://github.com/DigitallyRefined.png","language":"Python","funding_links":["https://liberapay.com/DigitallyRefined"],"categories":[],"sub_categories":[],"readme":"# Cloudflare Speed Test for Home Assistant\n\n[![Validate with hassfest](https://github.com/DigitallyRefined/ha-cloudflare-speed-test/actions/workflows/hassfest.yaml/badge.svg)](https://github.com/DigitallyRefined/ha-cloudflare-speed-test/actions/workflows/hassfest.yaml)\n[![HACS Validate](https://github.com/DigitallyRefined/ha-cloudflare-speed-test/actions/workflows/hacs_action.yml/badge.svg)](https://github.com/DigitallyRefined/ha-cloudflare-speed-test/actions/workflows/hacs_action.yml)\n[![hacs_badge](https://img.shields.io/badge/HACS-Default-blue.svg)](https://github.com/custom-components/hacs)\n\n![downloads](https://img.shields.io/github/downloads/DigitallyRefined/ha-cloudflare-speed-test/total.svg)\n![downloads](https://img.shields.io/github/downloads/DigitallyRefined/ha-cloudflare-speed-test/latest/total.svg)\n\nThis integration uses the [cloudflarepycli](https://pypi.org/project/cloudflarepycli/) Python library to retrieve network performance statistics from [https://speed.cloudflare.com](https://speed.cloudflare.com) including:\n\n* 90th percentile down/up\n* 25MB down\n* 10MB down/up\n* 1MB down/up\n* 100kB down/up\n* Latency\n* Jitter\n* ISP\n* IP address\n\nIt also attaches the test servers city, region and code to each result.\n\n## Installation\n\n### Using HACS  \n\nIf you dont' have [HACS](https://hacs.xyz) installed yet, I highly recommend it.  \n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=DigitallyRefined\u0026repository=ha-cloudflare-speed-test\u0026category=integration)  \nOr search for `Cloudflare Speed Test` in HACS or copy this GitHub URL and add it as a custom integration repository.\n\n### Manual  \n\n[Download the latest `cloudflare_speed_test.zip` release](https://github.com/DigitallyRefined/ha-cloudflare-speed-test/releases) and extract it into your `\u003cconfig\u003e/custom_component` folder.\n\n### Setup\n\nAfter installation you need to **restart** Home Assistant before using this integration.\n\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=cloudflare_speed_test)  \nOr go to **Settings** -\u003e **Devices \u0026 Services**  \nClick **Add integration** and search for `Cloudflare Speed Test`\n\n## Configuration\n\nBy default, a speed test will be run every hour or you can set a custom interval.\n\nIf you want to select an exact time when the speed test should run (e.g. to be more specific such as once a day over night) you can disable the default polling interval and create your own timed automation.\n\nTo disable polling and create your own timed automation:\n\n1. Go to **Settings** \u003e **Devices \u0026 services**, and select the Cloudflare Speed Test integration.\n2. On the integration entry, select the hamburger menu icon\n   * Then, select **System options** and toggle the button to disable polling.\n3. To define your custom polling interval, create an automation.\n   1. Go to [**Settings** \u003e **Automations \u0026 scenes**](https://my.home-assistant.io/redirect/automations) and create a new automation.\n   2. Define any triggers/conditions you like (e.g. a time trigger).\n   3. Select **Add action**, then, search/select **Perform action**.\n   4. Search/select the [`homeassistant.update_entity` action](https://www.home-assistant.io/integrations/homeassistant/#action-homeassistantupdate_entity).\n   5. Search/select the `cloudflare_speed_test_90th_percentile_down` entity (note: you only need to select one Cloudflare entity, the other entities will be automatically updated).\n4. Save the automation to automatically trigger based on your own schedule.\n\n### Add to dashboard\n\n![Graph screenshot](screenshot.webp)\n\nTo add graphs to your dashboard, the following YAML can be used in a manual card:\n\n\u003cdetails\u003e\n\u003csummary\u003eExpand for dashboard YAML\u003c/summary\u003e\n\n```yaml\ntype: vertical-stack\ncards:\n  - chart_type: line\n    period: day\n    type: statistics-graph\n    entities:\n      - sensor.cloudflare_speed_test_90th_percentile_down\n      - sensor.cloudflare_speed_test_25mb_down\n      - sensor.cloudflare_speed_test_10mb_down\n      - sensor.cloudflare_speed_test_1mb_down\n      - sensor.cloudflare_speed_test_100kb_down\n    stat_types:\n      - max\n    title: Download speed\n  - chart_type: line\n    period: day\n    type: statistics-graph\n    entities:\n      - sensor.cloudflare_speed_test_90th_percentile_up\n      - sensor.cloudflare_speed_test_10mb_up\n      - sensor.cloudflare_speed_test_1mb_up\n      - sensor.cloudflare_speed_test_100kb_up\n    stat_types:\n      - max\n    title: Upload speed\n  - chart_type: line\n    period: day\n    type: statistics-graph\n    entities:\n      - sensor.cloudflare_speed_test_latency\n      - sensor.cloudflare_speed_test_jitter\n    stat_types:\n      - min\n    title: Ping\n```\n\u003c/details\u003e\n\n## Notes\n\n* When running on Raspberry Pi the maximum speed is limited by the LAN adapter. The Raspberry Pi 3+ models come with a Gigabit LAN adapter which supports a [maximum throughput](https://www.raspberrypi.org/products/raspberry-pi-3-model-b-plus/) of 300 Mbit/s.\n* Running this integration can have negative effects on the system’s performance as it requires a fair amount of memory.\n* If run frequently, this integration has the ability to use a considerable amount of data. Frequent updates should be avoided on bandwidth-capped connections.\n* While a speed test is running your network capacity is fully utilized. This may have a negative effect on other devices using the network such as gaming consoles or streaming boxes.\n* This integration and its author are **not** affiliated or associated with Cloudflare.\n\n## Attribution\n\nOriginal idea from [@rohankapoorcom, @engrbm87](https://github.com/home-assistant/core/tree/dev/homeassistant/components/speedtestdotnet)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitallyrefined%2Fha-cloudflare-speed-test","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitallyrefined%2Fha-cloudflare-speed-test","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitallyrefined%2Fha-cloudflare-speed-test/lists"}