{"id":45897523,"url":"https://github.com/tomvanswam/compass-card","last_synced_at":"2026-02-27T21:19:21.061Z","repository":{"id":36976829,"uuid":"286038496","full_name":"tomvanswam/compass-card","owner":"tomvanswam","description":"A Lovelace card that shows a directional indicator on a compass for Home Assistant","archived":false,"fork":false,"pushed_at":"2026-02-26T20:41:08.000Z","size":3452,"stargazers_count":229,"open_issues_count":17,"forks_count":24,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-02-27T01:37:11.391Z","etag":null,"topics":["compass","hacs","home-assistant","lovelace-card"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/tomvanswam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["tomvanswam"],"custom":["https://www.buymeacoffee.com/tomvanswam/"]}},"created_at":"2020-08-08T12:24:45.000Z","updated_at":"2026-02-24T04:32:40.000Z","dependencies_parsed_at":"2024-11-25T20:23:53.273Z","dependency_job_id":"12933fe7-c00a-44a5-b2a4-46557dadbe1c","html_url":"https://github.com/tomvanswam/compass-card","commit_stats":null,"previous_names":[],"tags_count":44,"template":false,"template_full_name":"custom-cards/boilerplate-card","purl":"pkg:github/tomvanswam/compass-card","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomvanswam%2Fcompass-card","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomvanswam%2Fcompass-card/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomvanswam%2Fcompass-card/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomvanswam%2Fcompass-card/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomvanswam","download_url":"https://codeload.github.com/tomvanswam/compass-card/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomvanswam%2Fcompass-card/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29914466,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"ssl_error","status_checked_at":"2026-02-27T19:37:41.463Z","response_time":57,"last_error":"SSL_read: 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":["compass","hacs","home-assistant","lovelace-card"],"created_at":"2026-02-27T21:19:20.639Z","updated_at":"2026-02-27T21:19:21.053Z","avatar_url":"https://github.com/tomvanswam.png","language":"TypeScript","funding_links":["https://github.com/sponsors/tomvanswam","https://www.buymeacoffee.com/tomvanswam/","https://www.buymeacoffee.com/tomvanswam"],"categories":["TypeScript"],"sub_categories":[],"readme":"# Compass card\n\nA custom [Home Assistant](https://home-assistant.io/) dashboard card that displays an indicator in a circle.\n\n[![GitHub Release][releases-shield]][releases-link] [![GitHub Release Date][release-date-shield]][releases-link] [![GitHub Releases][latest-download-shield]][traffic-link] [![GitHub Releases][total-download-shield]][traffic-link]\n\n[![HACS Badge][hacs-shield]][hacs-link] [![HomeAssistant][home-assistant-shield]][home-assistant-link] [![License][license-shield]][license-link]\n\n![Project Maintenance][maintenance-shield] [![GitHub Activity][activity-shield]][activity-link] [![Open bugs][bugs-shield]][bugs-link] [![Open enhancements][enhancements-shield]][enhancement-link]\n\n[![Community Forum][forum-shield]][forum-link] [![Buy Me A Coffee][coffee-shield]][coffee-link]\n\n## Example\n\n![compass-card](images/card.png)\n\n## Installation\n\n### [HACS](https://hacs.xyz/) (Home Assistant Community Store)\n\n1. Go to HACS page on your Home Assistant instance\n1. Select `Frontend`\n1. Press add icon and search for `compass`\n1. Select Compass Card repo and install\n1. Force refresh the Home Assistant page (\u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eR\u003c/kbd\u003e)\n1. Add compass-card to your page\n\n### Manual\n\n1. Download the 'compass-card.js' from the latest [release](https://github.com/tomvanswam/compass-card/releases) (with right click, save link as)\n1. Place the downloaded file on your Home Assistant machine in the `config/www` folder (when there is no `www` folder in the folder where your `configuration.yaml` file is, create it and place the file there)\n1. In Home Assistant go to `Configuration-\u003eLovelace Dashboards-\u003eResources` (When there is no `resources` tag on the `Lovelace Dashboard` page, enable advanced mode in your account settings, and retry this step)\n1. Add a new resource\n   1. Url = `/local/compass-card.js`\n   1. Resource type = `module`\n1. Force refresh the Home Assistant page (\u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eF5\u003c/kbd\u003e)\n1. Add compass-card to your page\n\n## Using the card\n\n- Add the card with the visual editor\n- Or add the card manually and [configure it with YAML](https://github.com/tomvanswam/compass-card/wiki/1.-YAML-configuration)\n\n## Wish/Todo list\n\n- See [open enhancements](https://github.com/tomvanswam/compass-card/issues?q=state%3Aopen%20label%3Aenhancement)\n\n## Contact\n\nYou can find me on the [Home Assistant Community Site](https://community.home-assistant.io/t/compass-card-points-you-in-the-right-direction/217909)\u003cbr /\u003e\nAnd occasionally on the [HACS](https://discord.gg/apgchf8) and [Home Assistant](https://www.home-assistant.io/join-chat) Discord\n\n## Thanks to\n\n- [@rsnodgrass](https://github.com/rsnodgrass) for the idea to make this\n- [@iantrich](https://www.github.com/iantrich) for the [boiler-plate card](https://github.com/custom-cards/boilerplate-card), which got me started\n- [@vingerha](https://github.com/vingerha) for creating the dynamic background image, mdi icon support and much more\n- [All the translators](https://github.com/tomvanswam/compass-card/wiki/1.-YAML-configuration#language)\n\n## Support\n\nHelp me out for a couple of :beers:, a :coffee: or legos!\u003cbr /\u003e\nOr clone, and create and a PR to help make the card even better.\n\n[![coffee](https://www.buymeacoffee.com/assets/img/custom_images/black_img.png)](https://www.buymeacoffee.com/tomvanswam)\n\n[releases-shield]: https://img.shields.io/github/release/tomvanswam/compass-card.svg?style=flat-square\n[releases-link]: https://github.com/tomvanswam/compass-card/releases/latest\n[release-date-shield]: https://img.shields.io/github/release-date/tomvanswam/compass-card?style=flat-square\n[latest-download-shield]: https://img.shields.io/github/downloads/tomvanswam/compass-card/latest/total?style=flat-square\u0026label=downloads%20latest%20release\n[total-download-shield]: https://img.shields.io/github/downloads/tomvanswam/compass-card/total?style=flat-square\u0026label=total%20views\n[traffic-link]: https://github.com/tomvanswam/compass-card/graphs/traffic\n[hacs-shield]: https://img.shields.io/badge/HACS-Default-orange.svg?style=flat-square\n[hacs-link]: https://github.com/hacs/integration\n[home-assistant-shield]: https://img.shields.io/badge/Home%20Assistant-visual%20editor/yaml-green?style=flat-square\n[home-assistant-link]: https://www.home-assistant.io/\n[license-shield]: https://img.shields.io/github/license/custom-cards/boilerplate-card.svg?style=flat-square\n[license-link]: LICENSE.md\n[activity-shield]: https://img.shields.io/github/commit-activity/y/tomvanswam/compass-card.svg?style=flat-square\n[activity-link]: https://github.com/tomvanswam/compass-card/commits/master\n[bugs-shield]: https://img.shields.io/github/issues/tomvanswam/compass-card/bug?color=red\u0026style=flat-square\u0026label=bugs\n[bugs-link]: https://github.com/tomvanswam/compass-card/labels/bug\n[enhancements-shield]: https://img.shields.io/github/issues/tomvanswam/compass-card/enhancement?color=blue\u0026style=flat-square\u0026label=enhancements\n[enhancement-link]: https://github.com/tomvanswam/compass-card/labels/enhancement\n[maintenance-shield]: https://img.shields.io/maintenance/yes/2026.svg?style=flat-square\n[forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg?style=flat-square\n[forum-link]: https://community.home-assistant.io/t/compass-card-points-you-in-the-right-direction/217909\n[coffee-shield]: https://img.shields.io/badge/donate-buymeacoffe-sienna?style=flat-square\n[coffee-link]: https://www.buymeacoffee.com/tomvanswam\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomvanswam%2Fcompass-card","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomvanswam%2Fcompass-card","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomvanswam%2Fcompass-card/lists"}