{"id":19526116,"url":"https://github.com/ericoc/alexa-seizuretracker","last_synced_at":"2025-04-26T10:31:11.528Z","repository":{"id":147419521,"uuid":"86177364","full_name":"ericoc/alexa-seizuretracker","owner":"ericoc","description":"Alexa Skill Development for SeizureTracker.com","archived":false,"fork":false,"pushed_at":"2017-12-30T19:12:57.000Z","size":313,"stargazers_count":5,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-10-20T19:43:36.506Z","etag":null,"topics":["alexa","alexa-custom-skill","alexa-skill","alexa-skill-development","alexa-web-service","amazon","amazon-alexa-development","amazon-alexa-php","amazon-alexa-skill","amazon-echo","echo","echo-api","echo-dot","epilepsy","php","seizure-tracker","seizures","seizuretracker","voice","voice-commands"],"latest_commit_sha":null,"homepage":"https://www.amazon.com/Seizure-Tracker/dp/B074HBVHRJ/","language":"PHP","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/ericoc.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,"governance":null}},"created_at":"2017-03-25T17:56:44.000Z","updated_at":"2023-10-20T19:43:36.917Z","dependencies_parsed_at":null,"dependency_job_id":"c5292d5f-2afe-4c74-a129-9903ae4de3b9","html_url":"https://github.com/ericoc/alexa-seizuretracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoc%2Falexa-seizuretracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoc%2Falexa-seizuretracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoc%2Falexa-seizuretracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericoc%2Falexa-seizuretracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ericoc","download_url":"https://codeload.github.com/ericoc/alexa-seizuretracker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224032233,"owners_count":17244373,"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":["alexa","alexa-custom-skill","alexa-skill","alexa-skill-development","alexa-web-service","amazon","amazon-alexa-development","amazon-alexa-php","amazon-alexa-skill","amazon-echo","echo","echo-api","echo-dot","epilepsy","php","seizure-tracker","seizures","seizuretracker","voice","voice-commands"],"created_at":"2024-11-11T01:08:20.384Z","updated_at":"2024-11-11T01:08:22.217Z","avatar_url":"https://github.com/ericoc.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Amazon Alexa Skill: Seizure Tracker\n\nThis repository is for development of an Amazon Alexa skill that can be used on Amazon Echo and Echo Dot devices to track epileptic seizures via [SeizureTracker.com](https://www.seizuretracker.com).\n\nThe Amazon Alexa Skill can be enabled at [https://www.amazon.com/Seizure-Tracker/dp/B074HBVHRJ/](https://www.amazon.com/Seizure-Tracker/dp/B074HBVHRJ/) and requires a (free) SeizureTracker.com account!\n\n---\n\n### How does this thing work?\n\n#### Account linking\n\nA users Alexa account/device must be linked to their SeizureTracker.com account in order for the skill to function at all.\n\nLinking an Amazon Alexa account to a SeizureTracker.com account is done within [login.php](login.php) where OAuth is used.\n\n#### Voice commands\n\nWhen a voice command is made to the Seizure Tracker Alexa skill, Amazon POSTs JSON HTTPS requests to [seizure.php](seizure.php) - which includes the users \"intent\" as determined by Amazon.\n\nAmazon determines a users intent using a custom JSON configuration defined for the skill by the skill developer. In this case, the JSON configuration for the intent model is defined per [configuration.json](configuration.json).\n\nIf a voice command request is valid and for one of the three primary functions of the skill, then the contents of a request is forwarded from [seizure.php](seizure.php) to the `handle_seizure` PHP function within [seizure.events.php](seizure.events.php).\n\n##### Primary functions\n\nThere are three primary functions within [seizure.events.php](seizure.events.php) (which is called by [seizure.php](seizure.php)) that interact with the SeizureTracker.com API to do the following things via Alexa voice commands:\n\n| Alexa Intent    | PHP Function      | Purpose                                             |\n| --------------- | ----------------- | --------------------------------------------------- |\n| `CountSeizures` | `count_seizures`  | Count seizures that have occurred today             |\n| `AddSeizure`    | `add_seizure`     | Track a new seizure                                 |\n| `EndSeizure`    | `end_seizure`     | Mark a (previously tracked) seizure as having ended |\n\n---\n\n### Future Plans?\n\n#### Including these capabilities could be useful:\n  * Track whether seizure medication was taken\n  * Track vagal nerve stimulator (VNS) usage\n\n#### \"Flash Briefing\" ideas:\n  * Medication reminder\n  * Announce count of seizures for the prior day\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericoc%2Falexa-seizuretracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fericoc%2Falexa-seizuretracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericoc%2Falexa-seizuretracker/lists"}