Skip to content

Latest commit

 

History

History
120 lines (76 loc) · 5.12 KB

README.md

File metadata and controls

120 lines (76 loc) · 5.12 KB

EEGscape

EEGscape is a groundbreaking project designed to make gaming accessible to individuals with disabilities while also offering unique challenges to able-bodied users. By utilizing EEG (electroencephalogram) technology, we enable players to interact with games using head movements, concentration, and blinks, creating an immerse and inclusive gaming experience.

🚀 Inspiration

EEGscape started with a simple idea: let’s make gaming something everyone can enjoy, no matter what challenges they face. Traditional controllers can be tough for people who don’t have full motor control, so we thought, "Why not use your brain instead?" But wait, there’s more! EEGscape isn’t just about accessibility—it’s a workout for your brain, too. Think of it as leveling up your focus and memory while playing awesome games. We’re just scratching the surface of what tech can do to make gaming fun, inclusive, and maybe even a little mind-bending.

🎮 What It Does

EEGscape uses EEG-powered headset like Muse to translate brain activity and physical gestures into in-game commands. Players can control a suite of interactive video games through:

  • Head Tilts: Gyroscope data is used to detect head orientation for directional inputs.
  • Concentration: Cognitive effort influences actions such progress in certain games.
  • Blinking: Deliberate eye blinks are mapped to specific controls like stacking towers. These innovative input uses controls such as gyroscopes, brainwaves, and other actions that are built into the EEG headset.

🛠️ How We Built It

EEGscape combines cutting-edge hardware and modern web technologies to deliver an engaging experience:

  1. Frontend Development: The React framework serves as the foundation of our user interface, ensuring a dynamic and responsive experience.
  2. Real-Time EEG Data: We used the MuseJS library to interpret raw signals from the EEG headset, including gyroscopic data, brainwave frequencies, and blink patterns.
  3. Game Development: Games were built using JavaScript to provide seamless interaction and integrate with the EEG-powered input methods.
  4. Styling: Tailwind CSS and DaisyUI were used to create a visually appealing and user-friendly interface.

Challenges We Faced

1. Interpreting Raw EEG Data

The headset provides raw data streams from various sensors, and this involved:

  • Filtering noise from brainwave signals.
  • Establishing thresholds for actions like blinks or head tilts.
  • Mapping concentration levels to meaningful in-game responses.

2. Hardware-Software Integration

Seamlessly linking the EEG headset's output with the React frontend was a challenge, particularly ensuring that the input methods felt intuitive and lag-free.

3. Game Design

Developing engaging games that effectively utilized the limited input methods required careful design and iteration.

🌱 What We Learned

EEGscape was a journey of discovery. Along the way, we:

  • Explored EEG Technology: We gained hands-on experience with interpreting brain activity and linking it to software applications. Most of our team members were working with this technology for the first time.
  • Refined Game Development Techniques: Designing games that are both fun and accessible required out-of-the-box thinking.

🔮 What's Next for EEGscape

EEGscape is a platform with immense potential for future development. Here’s what’s on the horizon:

1. Expanding the Game Library

Adding more games to provide diverse and engaging experiences for players with different preferences.

2. Leveraging Additional Sensors

Incorporating the headset’s heart rate sensor to create adaptive game mechanics, such as:

  • Increasing game difficulty during moments of high stress.
  • Introducing relaxation modes to help players unwind.

3. Community Involvement

Encouraging contributions from developers and players to create custom games and features that enrich the EEGscape ecosystem. Using Dojo from Starknet to allow users to deploy custom mini games on the application.

🛠️ Built With

  • React: Frontend framework for building the user interface.
  • Vite: Fast build tool for modern web development.
  • Tailwind CSS: Utility-first CSS framework for styling.
  • DaisyUI: UI components for enhanced visuals.
  • MuseJS: Library for interfacing with Muse EEG headsets.

📖 Getting Started

Prerequisites

  • A Muse EEG headset compatible with MuseJS.
  • Node.js installed on your system.

Installation

  1. Clone the repository: 
    git clone https://github.com/your-username/EEGscape.git
cd EEGscape
  2. Install dependencies: 
    npm install
  3. Run the application: 
    npm run dev

Contributors

This project was created for Hack Western 11 by the following people: