Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/retiutut/openbci_emg_slideshow
Allow users with/without disabilities to control a slideshow using simple muscle movements and OpenBCI tech.
https://github.com/retiutut/openbci_emg_slideshow
Last synced: about 1 month ago
JSON representation
Allow users with/without disabilities to control a slideshow using simple muscle movements and OpenBCI tech.
- Host: GitHub
- URL: https://github.com/retiutut/openbci_emg_slideshow
- Owner: retiutut
- License: mit
- Created: 2019-06-04T18:20:53.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-07-19T21:19:45.000Z (over 4 years ago)
- Last Synced: 2023-10-19T21:32:52.375Z (about 1 year ago)
- Language: Max
- Homepage:
- Size: 6.79 MB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# EMG Slideshow
This app allows a user to control a slideshow of pictures and movies from a given file directory using muscles only (e.g. open and closing hands). Signal acquisition and processing are handled by the OpenBCI GUI. Normalized EMG data is then streamed via OSC to a simple neural network in Max. A facilitator prepares the user and has override control using a browser-based interface via MIRA.
### Prerequisites
- OpenBCI [Ganglion](https://shop.openbci.com/collections/frontpage/products/ganglion-board) or [Cyton](https://shop.openbci.com/collections/frontpage/products/cyton-biosensing-board-8-channel)
- [EMG/ECG Snap Electrode Cables](https://shop.openbci.com/collections/frontpage/products/emg-ecg-snap-electrode-cables)
- [EMG/ECG Foam Solid Gel Electrodes](https://shop.openbci.com/collections/frontpage/products/skintact-f301-pediatric-foam-solid-gel-electrodes-30-pack)
- [OpenBCI GUI](https://openbci.com/downloads)
- Windows or Mac computer
- Dedicated WiFi router (for wireless iPad/tablet control)
- iPad or other mobile device with a web browser
Optional:
- Secondary display
- HDMI or other video cable to connect to secondary display
### Installing
Install the OpenBCI GUI and connect with hardware, then stream the data to this app using Open Sound Control (OSC) via the Networking Widget.
### Setup and Electrode Placement
Use Channels 3 and 4 with either the Cyton or Ganglion. Refer to the following illustration for details. **Hand is palm up, with electrodes attached at specific locations on the inner forearm, with one electrode on the inner-lower bicep**. Ideally, user is sitting in a chair with arm rests or laying down. Direct user to let arm rest by his/her side with palm facing up.
### Controls
Using the Arm-Based approach and the suggested electrode placement, the user can control the slideshow with the following actions:
- Backward == Flex/Relax Right Arm
- Forward == Open/Close Right Hand
- Play/Pause == Close Hand and Flex Arm
Using the Head-Based approach with [Cyton 8 Channel board and default 10-20 locations](https://docs.openbci.com/docs/04AddOns/01-Headwear/MarkIV#electrode-location-overview):
- Backward == Left Eye Blink
- Forward == Right Eye Blink
- Play/Pause == Jaw Clench
## Built With
* [Max/MSP](https://cycling74.com/) - Visual Programming Language
* [Open Sound Control](http://opensoundcontrol.org/introduction-osc)
* [OpenBCI GUI](https://openbci.com/downloads)
## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/retiutut/emg_slideshow/tags).
## Authors
##### Created by Richard Waltman, June 2019
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details
## THINGS I INSTALLED:
* ml.star (Max package manager)
* [CNMAT-odot](https://github.com/CNMAT/CNMAT-odot/releases)
* MIRA (Max package manager)