{"id":13744204,"url":"https://github.com/NeuroTechX/eeg-101","last_synced_at":"2025-05-09T02:33:03.456Z","repository":{"id":52927759,"uuid":"52444548","full_name":"NeuroTechX/eeg-101","owner":"NeuroTechX","description":"Interactive neuroscience tutorial app using Muse and React Native to teach EEG and BCI basics.","archived":true,"fork":false,"pushed_at":"2021-04-13T16:48:41.000Z","size":66067,"stargazers_count":245,"open_issues_count":0,"forks_count":56,"subscribers_count":35,"default_branch":"master","last_synced_at":"2024-11-15T15:42:24.420Z","etag":null,"topics":["android","bci","eeg","muse","plotting","react-native"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NeuroTechX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-24T13:31:50.000Z","updated_at":"2024-10-15T07:15:26.000Z","dependencies_parsed_at":"2022-08-24T11:31:01.907Z","dependency_job_id":null,"html_url":"https://github.com/NeuroTechX/eeg-101","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuroTechX%2Feeg-101","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuroTechX%2Feeg-101/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuroTechX%2Feeg-101/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuroTechX%2Feeg-101/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NeuroTechX","download_url":"https://codeload.github.com/NeuroTechX/eeg-101/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253177877,"owners_count":21866411,"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":["android","bci","eeg","muse","plotting","react-native"],"created_at":"2024-08-03T05:01:05.098Z","updated_at":"2025-05-09T02:33:00.299Z","avatar_url":"https://github.com/NeuroTechX.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Software"],"sub_categories":["Mobile Apps"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"banner\" src=\"/images/EEG101graphic.png/\" width=\"600\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\" href=\"\"\u003e\n  An Interactive EEG tutorial that _taught_ EEG and BCI basics.\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"http://neurotechx.herokuapp.com/\"\u003e\n    \u003cimg src=\"http://neurotechx.herokuapp.com/badge.svg\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n## EEG 101 is dead, may it rest in peace.\nDue to Interaxon rescinding support for its Muse SDK, it is no longer possible for open-source developers to build mobile apps that connect to Muse devices, including this one. Thus, we have stopped development here and removed the app from the Google Play Store. \n\nIf you are interested in learning or teaching EEG, we recommend you check out the [EEGEdu](https://github.com/kylemath/EEGEdu) project, which we see as the spiritual successor to EEG 101, expanding on the EEG 101 experience by adding features that we could only have dreamed of when we started this project back in 2016.\n\nGood luck and happy neurohacking,\u003cbr\u003e\nDano\n\n\n## Overview\n- Teaches the basics of EEG, including where signals come from, how devices work, and how to process data\n- Contains a general purpose binary classifier for EEG data\n- Streams data from the Muse with the LibMuse Java API\n- Built with React Native for Android\n- Completely free, open-source, and available for use/adaption in any project\n\n## Video Walkthrough\n\nhttps://www.youtube.com/watch?v=fDQZ5zWVjY0\u0026feature=youtu.be\n\n## Lesson Content\n- Neurophysiology of EEG\n- EEG hardware\n- Filtering\n- Epoching\n- Artefact Removal\n- The Fourier Transform\n- The Power Spectral Density Curve\n- Brain waves\n- Brain-Computer Interfaces\n- Machine Learning\n\n## How it works\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"screens\" src=\"/images/ScreenBanner.png/\"\u003e\n\u003c/p\u003e\n\nOur goal with EEG 101 was to create a flexible base for EEG and BCI mobile development that novice programmers can build on top of for multiple platforms with different EEG devices. To satisfy those concerns, we've built the app in React Native, which allows for fast, straight-forward front-end development and the potential to port to iOS, Web, or Desktop (Electron) in the future.  \n\nCurrently, EEG 101 is split right down the middle between Java and React. If you're interested in how we [connect to the Muse](https://github.com/NeuroTechX/eeg-101/blob/master/EEG101/android/app/src/main/java/com/eeg_project/components/connector/ConnectorModule.java), [process EEG data](https://github.com/NeuroTechX/eeg-101/tree/master/EEG101/android/app/src/main/java/com/eeg_project/components/signal), and [plot the results](https://github.com/NeuroTechX/eeg-101/blob/master/EEG101/android/app/src/main/java/com/eeg_project/components/graphs/EEGGraph.java) in real time, check out the graph and signal classes in the android source folders. Our implementations are all (for the most part) typical Android components written in Java.\n\nIf you'd like to use EEG 101 as a base for your own app in React Native, take a look at how we've written the tutorial in the src folder. Connecting to a Muse and plotting real-time EEG data is as simple as using one of the Native components we have already prepared.\n\n## Setup (instructions may be out of date)\n\n1. Install and setup [React Native](https://facebook.github.io/react-native/docs/getting-started.html). Note: EEG 101 uses lots of native code, so create-react-native-app and Expo are not an option. Follow the instructions for \"Building Apps with Native Code.\" You may also need to install the [JDK](https://www3.ntu.edu.sg/home/ehchua/programming/howto/JDK_Howto.html), [Node](https://nodejs.org/en/download/package-manager/), [Watchman](https://medium.com/@vonchristian/how-to-setup-watchman-on-ubuntu-16-04-53196cc0227c), and the [Gradle Daemon](https://docs.gradle.org/2.9/userguide/gradle_daemon.html) as well\n2. Install [yarn](https://github.com/yarnpkg/yarn)\n3. Clone this repo `git clone https://github.com/NeuroTechX/eeg-101.git`\n4. Download the LibMuse SDK from [Muse's developer website](http://developer.choosemuse.com/android). We've already taken care of integrating the sdk library into the app, so just make sure you end place libmuse_android.so in `\u003cclonedRepoName\u003e/EEG101/android/app/src/main/jniLibs/armeabi-v7a/` and libmuse_android.jar in `\u003cclonedRepoName/EEG101/android/app/libs/`\n5. run `yarn install` in the EEG101 folder\n6. Connect an Android device with USB debug mode enabled. Because the LibMuse library depends on an ARM architecture, EEG 101 will not build in an emulator\n7. Run `react-native start` to start React packager\n8. In new terminal, run `adb reverse tcp:8081 tcp:8081` to ensure debug server is connected to your device and then `react-native run-android` to install EEG 101\n\n## Common setup problems\n\n1. Gradle build error: Attribute \"title\" has already been defined\n\n- Solution: Make sure build tools is using latest version in in app/build.gradle (ie. 25.0.1) [http://stackoverflow.com/questions/39184283/attribute-title-has-already-been-define-when-have-android-plot-dependencies-1]\n\n2. INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package com.eeg_project signatures do not match the previously installed version; ignoring!\n\n- Solution: Uninstall any pre-existing versions of the app on your device\n\n3. Could not connect to development server\n\n- Solution: Make sure that the device is connected, run `adb reverse tcp:8081 tcp:8081`, and restart the React packager (`react-native-start`)\n\n4. Could not get BatchedBridge\n\n- Solution: Run `adb reverse tcp:8081 tcp:8081` again and reload\n\n 5. Error retrieving parent for item: No resource found that matches the given name 'android:TextAppearance.Material.Widget.Button.Borderless.Colored'\n\n - Solution: Make sure [compileSdkVersion and appcompat match](http://stackoverflow.com/questions/32075498/error-retrieving-parent-for-item-no-resource-found-that-matches-the-given-name) in in app build.gradle\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNeuroTechX%2Feeg-101","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNeuroTechX%2Feeg-101","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNeuroTechX%2Feeg-101/lists"}