{"id":23711308,"url":"https://github.com/princeegy/pymindwave2","last_synced_at":"2025-04-11T18:11:38.351Z","repository":{"id":241580942,"uuid":"807104179","full_name":"PrinceEGY/pymindwave2","owner":"PrinceEGY","description":"A Python package for seamless communication with Neurosky MindWave Mobile 2 headset.","archived":false,"fork":false,"pushed_at":"2025-01-12T13:56:56.000Z","size":844,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T14:11:10.475Z","etag":null,"topics":["eeg-data","eeg-headset","eeg-readings","eeg-signals","headset","mindwave","mindwave-headset","mindwave-mobile","mindwave-mobile2","motor-imagery","motor-imagery-tasks","neurosky-mindwave","neurosky-mindwave-headset","neurosky-mindwave-reader","python","python-package"],"latest_commit_sha":null,"homepage":"https://princeegy.github.io/pymindwave2/","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/PrinceEGY.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":"2024-05-28T13:43:48.000Z","updated_at":"2025-02-05T10:34:17.000Z","dependencies_parsed_at":"2024-05-29T05:35:45.484Z","dependency_job_id":"715f4789-c40e-4e0c-b78e-19d515a80a74","html_url":"https://github.com/PrinceEGY/pymindwave2","commit_stats":null,"previous_names":["princeegy/pymindwave2"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrinceEGY%2Fpymindwave2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrinceEGY%2Fpymindwave2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrinceEGY%2Fpymindwave2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrinceEGY%2Fpymindwave2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PrinceEGY","download_url":"https://codeload.github.com/PrinceEGY/pymindwave2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248456366,"owners_count":21106603,"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":["eeg-data","eeg-headset","eeg-readings","eeg-signals","headset","mindwave","mindwave-headset","mindwave-mobile","mindwave-mobile2","motor-imagery","motor-imagery-tasks","neurosky-mindwave","neurosky-mindwave-headset","neurosky-mindwave-reader","python","python-package"],"created_at":"2024-12-30T19:37:56.620Z","updated_at":"2025-04-11T18:11:38.331Z","avatar_url":"https://github.com/PrinceEGY.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Intro --\u003e\n# PyMindWave2\n\n\nA Python package that simplifies connecting and gathering data from the [Neurosky MindWave Mobile 2](https://store.neurosky.com/pages/mindwave) EEG headset.\n\nThis package is made to ease the process of data collection and interfacing with the **MindWave Mobile 2** EEG headset mainly for researchers and students who are interested in using the headset for their projects.\n\n\u003cu\u003e**Note:** This is an unofficial package and is not affiliated with [Neurosky](https://neurosky.com/).\u003c/u\u003e\n\n\u003c!-- Features --\u003e\n## Features\n\n- **Easy to use**: Provides a simple and intuitive API to interact with the headset.\n- **Data collection**: Provides a way to manage data collection sessions with different configurations.\n- **Event-driven**: Allows you to register callbacks for different events to ease the process of handling data.\n- **Built-in retry and timeout**: Automatically retries to connect to the headset if the connection fails.\n- **Fully documented**: You don't know what a function does? Just check the documentation.\n\n\u003c!-- Installation --\u003e\n## Installation\n\n**Prerequisites: Before installing the package, make sure to do the following:**\n\n-  Install the official NeuroSky [ThinkGear Connector](http://support.neurosky.com/kb/applications/what-is-the-thinkgear-connector-and-why-do-i-need-it) software on your computer. It enables communication between your computer and the headset through a serial port.\nYou can download it from [here](https://download.neurosky.com/public/Products/Utility/TGC/). And make sure it's running in the background.\n\n-  Pair the headset with your computer via Bluetooth. You can follow the instructions in [NeuroSky's pairing guide](http://support.neurosky.com/kb/mindwave-mobile-2/cant-pair-mindwave-mobile-2-with-computer-or-mobile-device).\n\nThen you can install the package using pip:\n\n```bash\npip install pymindwave2\n```\n\n\u003c!-- Usage --\u003e\n## Quick Start\n\n\nA minimal example to start a data collection session:\n```py\nfrom pymindwave2 import MindWaveMobile2, Session, SessionConfig\n\n# Initialize and connect to the headset\nheadset = MindWaveMobile2()\nsuccess = headset.start(n_tries=5, timeout=30)\n\nif success:  # if the headset is connected successfully\n    # Create a session configuration\n    sess_config = SessionConfig(\n        user_name=\"Ahmed\",\n        ...  # other configurations\n        classes=[\"left\", \"right\"]\n    )\n    \n    # Initialize and start the recording session\n    session = Session(headset, config=sess_config)\n    session.start()  # Start recording data\n    \n    while session.is_active:\n        pass  # wait for the session to finish\n    \n    session.save()  # save the recorded data to disk\n```\n\nfor more examples and detailed usage, check the [Examples](https://princeegy.github.io/pymindwave2/examples)\n\n\u003c!-- Contributing --\u003e\n## Contributing\nFeel free to contribute to this package to add, update, fix, and suggest other features.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprinceegy%2Fpymindwave2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprinceegy%2Fpymindwave2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprinceegy%2Fpymindwave2/lists"}