Project Mission
OpenShrooly is an open-source firmware project that liberates Shrooly mushroom cultivation devices from cloud dependency, giving users complete local control over their hardware. We believe in the principles of ownership, transparency, and community-driven development.
Why OpenShrooly?
The Problem
- Original Shrooly devices require cloud connectivity
- Proprietary app with limited customization
- Risk of service discontinuation
- Privacy concerns with cloud-based operation
- Limited integration with existing smart home systems
Our Solution
- 100% local control via web interface
- Full Home Assistant integration
- Open-source and transparent
- Community-driven development
- No cloud dependency
Project History
The OpenShrooly project began when a broken Shrooly device sparked curiosity about its inner workings. What started as a hardware teardown evolved into a full firmware replacement project.
Timeline
- Initial Teardown: Detailed analysis of Shrooly hardware
- Reverse Engineering: Protocol and communication discovery
- Firmware Development: Creating ESPHome-based replacement
- Community Formation: Growing group of contributors and users
- Ongoing Development: Continuous improvements and features
Features
Current Capabilities
- ✅ Local web interface
- ✅ Wi-Fi connectivity
- ✅ Environmental monitoring (temperature, humidity)
- ✅ Air exchange control
- ✅ Humidity management
- ✅ LED lighting control
- ✅ Home Assistant integration
- ✅ Over-the-air updates
In Development
- 🚧 Display support
- 🚧 Advanced automation
- 🚧 Multi-chamber coordination
- 🚧 Machine learning optimization
- 🚧 Mobile app
Community
OpenShrooly thrives on community contributions. Whether you’re a developer, mycologist, or enthusiastic user, there are many ways to get involved:
For Developers
- Contribute code improvements
- Help with reverse engineering
- Create integrations and tools
- Fix bugs and add features
For Growers
- Share cultivation experiences
- Test and refine settings
- Document growing techniques
- Help other users
For Everyone
- Report bugs and issues
- Suggest new features
- Improve documentation
- Spread the word
Open Source Philosophy
OpenShrooly is committed to open-source principles:
- Transparency: All code is publicly available
- Freedom: Modify and customize as needed
- Community: Collaborative development
- Education: Learn from and build upon the work
- Sustainability: Not dependent on any single company
Technical Stack
- Firmware: ESPHome (ESP32-S3)
- Backend: Local web server
- Frontend: Responsive web interface
- Integration: Home Assistant compatible
- Protocol: MQTT, REST API
- Documentation: This Hugo-based site
Safety and Disclaimer
⚠️ Important Warnings:
- Experimental Software: OpenShrooly is experimental and may cause device malfunction
- Warranty Void: Installing OpenShrooly voids your device warranty
- User Responsibility: Users assume all risks when installing this firmware
- Backup Essential: Always backup original firmware before installation
- No Guarantees: No guarantee of functionality or safety
Getting Help
Documentation
- This website provides comprehensive guides
- GitHub Wiki for additional resources
Community Support
- GitHub Issues for bug reports
- Discussions for questions
- Reddit community (if applicable)
Contributing
- Read our contribution guidelines
- Submit pull requests on GitHub
- Share your modifications and improvements
Credits
OpenShrooly exists thanks to:
- Graham Stewart: Project initiator and primary developer
- Contributors: All GitHub contributors
- Community: Users who test, report issues, and share knowledge
- ESPHome Team: For the excellent platform
- Home Assistant: For the integration ecosystem
Legal
This project is not affiliated with, endorsed by, or connected to the original Shrooly company. All trademarks belong to their respective owners.
OpenShrooly is provided “as-is” without any warranties. Users are responsible for compliance with local regulations regarding device modifications.
Future Vision
We envision a future where:
- All IoT devices respect user ownership
- Local control is the default, not exception
- Communities collaborate on hardware liberation
- Open-source alternatives exist for all smart devices
- Knowledge and control remain with users
Contact
- GitHub: github.com/grahamsz/openshrooly
- Project Lead: Graham Stewart (graha.ms)
Support the Project
If you find OpenShrooly useful:
- ⭐ Star the GitHub repository
- 🐛 Report bugs and issues
- 📝 Contribute documentation
- 💻 Submit code improvements
- 📢 Share with other Shrooly users
Together, we’re building a more open and user-controlled future for smart cultivation devices.