Magic Home - Support
Welcome to Magic Home support! Here you'll find answers to common questions and ways to get help.
What is Magic Home?
Magic Home is a mobile application that allows you to control and monitor compatible devices on your local network. The app connects to devices via WebSocket communication for real-time interaction.
Microcontroller Programming
To set up your ESP32 microcontroller and get the Magic Home app working with it, follow the step-by-step programming guide available in our documentation:
This guide covers everything from configuring Wi-Fi credentials and device names to setting up relays and uploading the code via PlatformIO.
Getting Started
Initial Setup
- Download and install Magic Home from the App Store
- Ensure your device and mobile phone are on the same Wi-Fi network
- Open the app and navigate to the connection settings
- Enter your device's IP address or hostname when prompted
- Tap Connect to establish the connection
Finding Your Device's IP Address
- Check your device's network settings or configuration page
- Look for "Network Information" or "Wi-Fi Settings"
- The IP address typically looks like:
192.168.1.100or10.0.0.50 - If using a hostname, make sure to include
.local(e.g.,esp32.local).
Frequently Asked Questions
Connection Issues
Q: The app says "Connection failed" or shows a timeout error
- Verify both devices are on the same Wi-Fi network
- Double-check the IP address you entered
- Ensure your device is powered on and network-enabled
- Try restarting both your mobile device and the target device
Q: The connection keeps dropping
- Check your Wi-Fi signal strength
- Ensure your router isn't blocking local network communication
- Try moving closer to your Wi-Fi router
Q: I can't find my device's IP address
- Check your router's admin panel for connected devices
- Look for device documentation or settings menu
- Try using network scanning apps to discover local devices
App Features
Q: How do I reset my connection settings?
- Go to app settings and tap "Reset" or "Clear Data"
- You can also uninstall and reinstall the app
Q: The app interface looks different than expected
- Make sure you have the latest version from the App Store
- Some features may vary based on your device capabilities
Technical Issues
Q: The app crashes or freezes
- Force close the app and reopen it
- Restart your mobile device
- Ensure you have sufficient storage space
- Update to the latest app version
Q: I'm seeing error messages
- Most errors are related to network connectivity
- Try disconnecting and reconnecting
- Check if your target device is responding
Troubleshooting Steps
- Check network connection
- Ensure Wi-Fi is enabled and connected
- Test internet connectivity
- Verify device compatibility
- Confirm your device supports the required protocols
- Check that WebSocket communication is enabled
- Restart everything
- Close and reopen the Magic Home app
- Restart your mobile device
- Power cycle your target device
- Reset app data
- Clear the app's stored data
- Re-enter your connection settings
System Requirements
- iOS: iOS 12.0 or later
- Network: Wi-Fi connection required
- Device: Compatible devices with WebSocket support
Privacy & Data
Magic Home respects your privacy:
- No personal data is collected or transmitted to external servers
- All communication stays within your local network
- Connection settings are stored only on your device
Contact Support
If you're still experiencing issues after trying the troubleshooting steps:
Email: magicbulletsoft@gmail.com
When contacting support, please include:
- Your device model and iOS version
- Magic Home app version
- Description of the issue
- Steps you've already tried
Response Time: I typically respond within 24-48 hours.
Feature Requests
Have an idea for improving Magic Home? I'd love to hear from you! Send your suggestions to the support email above.
App Updates
Magic Home is regularly updated with improvements and bug fixes. Make sure to keep your app updated through the App Store for the best experience.