Brain Rain

Interactive visualization of neural feedback through immersive rain scenes

An interactive meditation and relaxation application that creates an immersive rain environment responding to your brain activity using the Neurosity device. Built upon the Notion React Starter template, this project has evolved into a focused visualization tool for neural feedback.

🌟 Features

• 🧠 Neural Feedback - Real-time response to brain activity using Neurosity SDK
• 🌧️ Dynamic Rain Scene - Responsive rain intensity based on neural state
• 🔊 Ambient Audio - Immersive rain soundscapes
• 🎯 Customizable Thresholds - Fine-tune sensitivity for scene elements

🚀 Getting Started

Prerequisites

• Node.js (version 14 or higher)
• A Neurosity device
• npm or yarn package manager

Installation

1. Clone the repository:

git clone https://github.com/yourusername/brain-rain.git
cd brain-rain

Or create the directory:

mkdir c:\repos\brain-rain
cd c:\repos\brain-rain

2. Install dependencies:

npm install

3. Start the development server:

npm start

4. Open http://localhost:3000 in your browser

🔧 Configuration

The application requires a Neurosity device connection. You'll need to:

1. Power on your Neurosity device
2. Connect to your device's WiFi network
3. Log in with your Neurosity credentials in the app
4. Adjust visualization thresholds in the configuration panel to match your preferences

🏗️ Built With

• React - Frontend framework
• @neurosity/sdk - Brain-computer interface SDK
• React Router - Navigation and routing
• use-sound - Audio management
• js-yaml - YAML configuration support

📖 Usage

1. Connect your Neurosity device
2. Observe the dynamic rain scene that responds to your brain activity
3. Adjust thresholds using the configuration panel
4. Relax and let the rain create a calming atmosphere
5. Toggle audio elements as desired

The rain scene features various elements that respond to your neural activity:

• Rain intensity
• Ambient sound levels
• Visual effects

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License

🙏 Acknowledgments

• Neurosity for their amazing BCI technology
• Notion React Starter for the initial template

📫 Contact

If you have any questions or feedback, please open an issue in the GitHub repository.

---

Made with ❤️ for the brain-computer interface community