The humidity system uses a small fan above a wick to add humidity to the chamber. This was a major focus of OpenShrooly 0.4.0 development, requiring programming of the secondary Raspberry Pi 2040 microcontroller.
Dashboard Card
The humidity card shows:
- Current humidity in large text
- Target humidity below
- HUMIDIFYING badge when the humidifier is active
Humidity Settings
Click the Humidity card on the dashboard to open the humidity control modal.
Interactive Slider Controls
The humidity control features an intuitive drag-and-drop slider with three handles:
- Green center handle: Drag to set your target humidity percentage (60-100%)
- Left arrow (◀): Drag to adjust the lower hysteresis bound
- Right arrow (▶): Drag to adjust the upper hysteresis bound
How Hysteresis Works
The hysteresis band (shown as a light green zone) determines when the humidifier turns ON and OFF:
- Turns ON when humidity drops below the lower bound (Target - Hysteresis)
- Turns OFF when humidity rises above the upper bound (Target + Hysteresis)
Example: With Target: 74.5% and Hysteresis: 2.25%:
- Humidifier turns ON below 72.3% (74.5 - 2.25)
- Humidifier turns OFF above 76.8% (74.5 + 2.25)
This hysteresis band prevents the humidifier from constantly cycling on and off when humidity hovers near the target value.
Humidifier Speed
Humidifier Speed slider: Controls the intensity (50-100%).
- Lower speeds (50-70%): Quieter operation but runs longer to maintain humidity
- Higher speeds (80-100%): Faster humidification but noisier
The original Shrooly only ran at 100%, but 50% is often sufficient and much quieter.
See the Mushroom Settings Guide for species-specific humidity requirements.