{"id":21081715,"url":"https://github.com/openvoiceos/ovos-phal-plugin-dotstar","last_synced_at":"2026-02-05T05:02:30.736Z","repository":{"id":239933193,"uuid":"801003994","full_name":"OpenVoiceOS/ovos-PHAL-plugin-dotstar","owner":"OpenVoiceOS","description":"PHAL plugin for dotstar type LED's","archived":false,"fork":false,"pushed_at":"2026-01-26T01:47:23.000Z","size":43,"stargazers_count":2,"open_issues_count":9,"forks_count":2,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2026-01-26T17:21:33.456Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/OpenVoiceOS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["OpenVoiceOS"],"patreon":"openvoiceos","liberapay":"OpenVoiceOS-Foundation","custom":"https://paypal.me/openvoiceos"}},"created_at":"2024-05-15T12:15:54.000Z","updated_at":"2025-12-19T21:04:03.000Z","dependencies_parsed_at":"2026-01-01T03:01:12.163Z","dependency_job_id":null,"html_url":"https://github.com/OpenVoiceOS/ovos-PHAL-plugin-dotstar","commit_stats":null,"previous_names":["builderjer/ovos-phal-plugin-dotstar","openvoiceos/ovos-phal-plugin-dotstar"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/OpenVoiceOS/ovos-PHAL-plugin-dotstar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-PHAL-plugin-dotstar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-PHAL-plugin-dotstar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-PHAL-plugin-dotstar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-PHAL-plugin-dotstar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenVoiceOS","download_url":"https://codeload.github.com/OpenVoiceOS/ovos-PHAL-plugin-dotstar/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-PHAL-plugin-dotstar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29113189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T03:44:17.043Z","status":"ssl_error","status_checked_at":"2026-02-05T03:44:12.077Z","response_time":65,"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":[],"created_at":"2024-11-19T20:10:30.119Z","updated_at":"2026-02-05T05:02:30.721Z","avatar_url":"https://github.com/OpenVoiceOS.png","language":"Python","readme":"# ovos-PHAL-plugin-dotstar\n\n**Compatible with**\n* Respeaker 2/4/6/8 i2c microphone HAT's\n* Adafruit 2 mic VoiceBonnet\n\n# Usage\n\nThere are a few ways for this plugin to get enabled.\n\n* Enable manually\n\nAdd this to your `~/.config/mycroft/mycroft.conf`\n\n```json\n{\n    \"PHAL\": {\n        \"ovos-PHAL-plugin-dotstar\": {\n            \"enabled\": true\n        }\n    }\n}\n```\nWith this configuration, no other validation checks are made.  It is assuming you have a compatible HAT installed.\n\n* Automatically with [ovos-i2csound](https://github.com/OpenVoiceOS/ovos-i2csound)\n\nWhen `ovos-i2csound` is installed and running, it creates a file at `/etc/OpenVoiceOS/i2c_platform` with the HAT name it detected.  This plugin then checks that file and if a compatible HAT is detected, the plugin is activated.\n\n* Automatically with hardware detection\n\nIf the above two options don't work, the plugin tries to detect a compatible HAT using `i2c-detect`.  If a compatible device address is found, the plugin will activate.\n\nFrom this point, if you are using a ReSpeaker i2c microphone, your LED's should give you prompts of what is going on with your OVOS assistant.\n\n### Adafruit 2mic voicebonnet\n\nThe [Adafruit voicebonnet](https://learn.adafruit.com/adafruit-voice-bonnet/overview) can be used with this plugin, but it requires one more step of manual configuration.  While the above detection options will properly enable the plugin, this HAT uses different GPIO pins for it's LED's, therefore cannot be easily distinguished from a ReSpeaker 2mic HAT.\n\nAdd the following to your `~/.config/mycroft/mycroft.conf` file\n\n```json\n{\n    \"PHAL\": {\n        \"ovos-PHAL-plugin-dotstar\": {\n            \"dotstar_hat\": \"ADAFRUIT2MIC\"\n        }\n    }\n}\n```\n\nAnd restart OVOS\n\nYour LED's on your Adafruit voicebonnet will now show the same prompts as the ReSpeaker devices.\n\n## Custom Configuration\n\nColors and animations can be configured in `~/.config/mycroft/mycroft.conf`\n\n```json\n{\n    \"PHAL\": {\n        \"ovos-PHAL-plugin-dotstar\": {\n            \"main_color\": \"Mycroft blue\",\n            \"background_color\": \"OVOS red\",\n            \"listen_animation\": \"breath\",\n            \"talking_animation\": \"blink\"\n        }\n    }\n}\n```\n\n`main_color` -\u003e str:\n```\n    rgb value -\u003e \"32, 195, 63\"\n    name -\u003e \"blue\"\n    hex value -\u003e \"#22A7F0\"\n```\n\n`background_color` -\u003e str\n```\n    rgb value -\u003e \"32, 195, 63\"\n    name -\u003e \"red\"\n    hex value -\u003e \"#FF1A1A\"\n```\n\n`listen_animation` -\u003e str:\n```\n    one of:\n        'breathe'\n        'chase'\n        'fill'\n        'refill'\n        'bounce'\n        'blink'\n        'alternating'\n```\n\n`talking_animation` -\u003e str:\n```\n    one of:\n        'breathe'\n        'chase'\n        'fill'\n        'refill'\n        'bounce'\n        'blink'\n        'alternating'\n```\n## Conflicts With\n\nThere are two pre-existing plugins that either need uninstalled with pip, or blacklisted in your `mycroft.conf` file.\n\n[ovos-PHAL-plugin-respeaker2mic](https://github.com/OpenVoiceOS/ovos-PHAL-plugin-respeaker-2mic)\n[ovos-PHAL-plugin-respeaker4mic](https://github.com/OpenVoiceOS/ovos-PHAL-plugin-respeaker-4mic)\n\n### TODO\n\n- [x] Add more animations\n- [x] User configurable colors\n- [ ] Theme support\n- [x] User configurable animations\n- [ ] Add github tests and automation\n\nPlease enjoy this plugin and don't be afraid to create an [issue](#) if you run into any problems.\n","funding_links":["https://github.com/sponsors/OpenVoiceOS","https://patreon.com/openvoiceos","https://liberapay.com/OpenVoiceOS-Foundation","https://paypal.me/openvoiceos"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvoiceos%2Fovos-phal-plugin-dotstar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenvoiceos%2Fovos-phal-plugin-dotstar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenvoiceos%2Fovos-phal-plugin-dotstar/lists"}