{"id":15037265,"url":"https://github.com/amjabb/eegmindreader","last_synced_at":"2025-08-26T00:16:11.093Z","repository":{"id":129501915,"uuid":"112151317","full_name":"amjabb/eegMindReader","owner":"amjabb","description":"Software for EEG BCI communication, along with companion IOS app.","archived":false,"fork":false,"pushed_at":"2018-01-03T04:02:22.000Z","size":34615,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-13T12:29:01.062Z","etag":null,"topics":["bci","c","eeg","eeg-analysis","eeg-classification","eeg-headset","python2","swift3"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amjabb.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":"2017-11-27T05:26:25.000Z","updated_at":"2025-02-05T10:47:26.000Z","dependencies_parsed_at":"2023-04-27T11:17:22.103Z","dependency_job_id":null,"html_url":"https://github.com/amjabb/eegMindReader","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/amjabb/eegMindReader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amjabb%2FeegMindReader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amjabb%2FeegMindReader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amjabb%2FeegMindReader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amjabb%2FeegMindReader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amjabb","download_url":"https://codeload.github.com/amjabb/eegMindReader/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amjabb%2FeegMindReader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272150642,"owners_count":24882204,"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-08-25T02:00:12.092Z","response_time":1107,"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":["bci","c","eeg","eeg-analysis","eeg-classification","eeg-headset","python2","swift3"],"created_at":"2024-09-24T20:34:02.571Z","updated_at":"2025-08-26T00:16:11.056Z","avatar_url":"https://github.com/amjabb.png","language":"C","readme":"# Mind Reader\n\n## Deployment\n\nThe main focus of this project is to create a platform for simple use, high quality and mobile egg technology. The headset is able to detect electrical signals in the brain (via electroencephalography, or EEG) as well as muscular movements (electromyography, or EMG), both well known in the medical community. Once you have those signals, the real magic begins, which is the ability to map signals to different actions. By doing so, the user is effectively teaching the machine how to read a specific mind.\n\nThe next step is mapping specific thoughts to specific actions, analogous to programming a universal remote control. The key here is that the thought and action don't necessarily have to be the same.\n\nAny device can take the headset data and create an action based on the prediction. We are using a iOS application to prove this concept.\n\n### Prerequisites\n\n```\npython 2.7\nnode V8.0.0\nxcode 9.0+\n```\n\n### Installing\n\n```\nPip install requirement.txt\n```\n\n\n## Getting Started\n\n\nMain file in /eegCommLayer is sequence_mgmt.js which can be run with Node’s V8 JavaScript Engine. This file is a sequencer that makes multiple other file calls and hosts many subprocesses to communicate with the EEG Headset as well as the companion app. This sequence engine is run on dedicated hardware along with the necessary packages, extensive knowledge of platform is required to manually run engine. Once engine is started with is by default on power up of hardware, all UI controls take place through mobile application.\n\nTo build the companion app /SwiftApp XCode 9.0 + is required. Along with Cocoa Pods installed in XCode project root directory.\n\n## Mobile App Splashscreen\n\nhttps://appsite.skygear.io/eegmindreader/\n\n## Design\n\n### Headset\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"headset_model/Headset_Picture.png\" width=\"600\"/\u003e\n\u003c/p\u003e\n\n### State Machine\n\n```\n              Firebase\n             /        \\\n            /          \\ \n           /            \\\nState   iOS App        Headset\n-----   -------        -------\n0        Idle            NC\n1        Login           NC\n2        Train          Connecting\n3       TrainOne        Collecting Data for One\n4       TrainTwo        Collecting Data for Two\n5         Idle          Creating model\n6     Showing Output    Running data through model(Real-time)\n\n```\n\n### Running the tests\n\nIf you not already connected to the iOS application you can test using test script. This script acts as if you are triggering the flags to train data and make decisions.\n\n```\nnode test_firebase.js\n```\nExecute this command in parallel will running the firebase test script or using the iOS app.\n\n```\nnode sequence_mgmt.js\n```\n\n### Demo Video\n\n[![Youtube Video](https://img.youtube.com/vi/uhK6hbT17xc/0.jpg)](https://www.youtube.com/watch?v=uhK6hbT17xc) \n\u003c/br\u003e\nhttps://www.youtube.com/watch?v=uhK6hbT17xc\n\n## Versioning\n1.0\n\n## Authors\n\nSara Sepasian,\nAmir Jabbari,\nMohdi Habibi,\nTaylor Keairns\n\n\n## Acknowledgments\n\n* Thanks to professor Preet Kang for all his support and time\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famjabb%2Feegmindreader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famjabb%2Feegmindreader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famjabb%2Feegmindreader/lists"}