{"id":20885348,"url":"https://github.com/lab11/mindwave","last_synced_at":"2026-04-19T21:37:46.766Z","repository":{"id":18520613,"uuid":"21719676","full_name":"lab11/mindwave","owner":"lab11","description":null,"archived":false,"fork":false,"pushed_at":"2014-12-17T17:31:00.000Z","size":176,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-01-19T10:43:33.722Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lab11.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}},"created_at":"2014-07-11T03:08:26.000Z","updated_at":"2019-09-29T20:29:37.000Z","dependencies_parsed_at":"2022-07-12T22:00:30.610Z","dependency_job_id":null,"html_url":"https://github.com/lab11/mindwave","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fmindwave","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fmindwave/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fmindwave/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lab11%2Fmindwave/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lab11","download_url":"https://codeload.github.com/lab11/mindwave/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243267288,"owners_count":20263799,"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":[],"created_at":"2024-11-18T08:13:13.110Z","updated_at":"2025-12-26T21:49:21.048Z","avatar_url":"https://github.com/lab11.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"MindWave Headset Apps\n================\n\nThis repo contains all the apps related to the MindWave headset from NeuroSky.\nThe main app, MindWaveReader, is contained within mindwave_reader.py. Other apps, like mental_hue.py, build off of the MindWaveReader.\n\nDependencies\n------------\n\nYou will need to install the library python-mindwave.\n\n1. Clone the Git repo: https://github.com/akloster/python-mindwave\n2. `python setup.py install`\n\nYou may also need to install pyserial.\n\n1. `sudo pip install pyserial`\n\n\nTo Run\n-------\n\n### Headset Setup\n\nEasy. Just pair the headset with your computer over Bluetooth. The headset can be \nset into pairing mode by pushing the power switch up into the 'on' position \nand holding it for three seconds, until it starts flashing faster. Your computer\nshould then be able to see the headset.\n\n### Program Operation\n\nThere are two programs:\n\n1. **mindwave_reader.py**, which prints out the readings from the headset into the terminal\nand can optionally send them to GATD.\n2. **mental_hue.py**, which does everything mindwave_reader can do plus also changes a Philips\nHue bulb to reflect your meditation (blue) and attention (red) balance in real-time.\n\nThese operating instructions apply to both mindwave_reader.py and mental_hue.py.\n\nYou will need to edit the program you plan to run to use the correct serial port,\nwhich on a Mac at least will look something like /dev/tty.MindWaveMobile-DevA-4.\nThe serial_port parameter is at the top of each program, so it should be easy to change.\n\nThe serial port should be the only code editing you have to do. There are three other\nparameters that can all be specified through the programs' interfaces:\n\n1. **gatd (True/False)**. Determines whether or not the program sends data to GATD.\n2. **uniqname (string)**. Only necessary when sending data to GATD. This name is \nassociated with your data stream. If you don't have a uniqname, you can supply \nyour full name. If you don't want to provide identification, you can give a pseudonym \nor the empty string.\n3. **showspectrum (True/False)**. This determines whether or not the readings for each \nEEG frequency band are displayed in addition to the meditation and attention \nheuristics. There are eight frequency bands, so make sure your terminal window \nis fullscreen!\n\nEach program will use text-based menus to walk you through these preferences, \nbut if you know for sure what you want having to provide input manually gets obnoxious.\nThus, you can specify each of these parameters on the command-line.\n\n## Example Usages:\n\n```\npython mindwave_reader.py\npython mindwave_reader.py gatd=False\npython mindwave_reader.py showspectrum=True\npython mindwave_reader.py gatd=True uniqname=mclarkk showspectrum=False     *\npython mindwave_reader.py gatd=True uniqname=mclarkk showspectrum=True      *\npython mindwave_reader.py gatd=False showspectrum=True                      *\npython mindwave_reader.py gatd=False showspectrum=False                     *\n```\n\nIf you leave out any necessary parameters the program will just ask you to \nprovide them manually. The examples that are starred require no manual \nuser input.\n\n##TODO: \n\nMake the serial port a command-line parameter.\n\nHave Hue return to original state when mental_hue.py ends. Now it just turns off (with a warning).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flab11%2Fmindwave","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flab11%2Fmindwave","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flab11%2Fmindwave/lists"}