This custom component for Home Assistant provides integration with the Yamaha R-N301 network receiver, enabling control of various functions like power, volume, source selection, and media playback.
Updated for Home Assistant 2025.10+ - This integration has been modernized with config flow support, async HTTP calls, and compatibility with the latest Home Assistant versions.
- Power Control: Turn your receiver on or off
- Volume Control: Adjust the volume and mute state
- Source Selection: Choose between inputs like Optical, CD, Line, and more
- Media Playback: Control media playback including play, pause, stop, and track navigation
- Enhanced Media Information: Display track info, station names, and frequencies
- TUNER Preset Support: Switch between radio presets using next/previous buttons (works even without signal lock)
- NET RADIO Browse Media: Browse and select internet radio stations directly in Home Assistant
- Config Flow: Easy setup through Home Assistant UI with connection testing
- IP Address Management: Change receiver IP address through Home Assistant UI (Settings → Configure)
- Unique Entity ID: Full UI management support for device settings
- Modern Architecture: Fully async implementation compatible with Home Assistant 2025.10+
- Install HACS if you haven't already
- In HACS, go to Integrations
- Search for "Yamaha R-N301" and click Download
- Restart Home Assistant
- Go to Settings → Devices & Services → Integrations
- Click Add Integration and search for "Yamaha R-N301"
- Enter your receiver's IP address and optional name
🎉 Now available in HACS default repositories! No need to add custom repository URL anymore.
- Download or clone this repository
- Copy the
custom_components/rn301folder to your Home Assistantcustom_componentsdirectory - Restart Home Assistant
- Go to Settings → Devices & Services → Integrations
- Click Add Integration and search for "Yamaha R-N301"
- Enter your receiver's IP address and optional name
-
Install using Method 1 or 2 above
-
Add the following to your
configuration.yaml:media_player: - platform: rn301 host: YOUR_RECEIVER_IP name: Yamaha R-N301
-
Replace
YOUR_RECEIVER_IPwith your receiver's IP address -
Restart Home Assistant
Once installed and configured, the Yamaha R-N301 will appear as a media player entity in Home Assistant. You can:
- Use the Lovelace UI to control power, volume, source selection, and media playback
- Create automations and scripts using the media player services
- Access different input sources with varying capabilities:
- Full Control: Spotify, Net Radio, Server (play/pause/stop/skip/shuffle)
- TUNER Control: Power, volume, source, preset switching via next/previous track buttons
- Basic Control: Optical, CD, Line inputs (power/volume/source only)
When using the UI configuration flow, you can set:
- Host: IP address of your Yamaha R-N301 (required, can be changed later)
- Name: Custom name for the device (optional, defaults to "Yamaha R-N301", can be changed later)
Changing Configuration Later: You can modify the IP address and device name anytime through:
- Go to Settings → Devices & Services
- Find your Yamaha R-N301 integration
- Click Configure
- Update IP address and/or name
- The integration will automatically reload with new settings
This integration is developed for the Yamaha R-N301 but might work with other Yamaha receivers with similar XML control APIs.
- Home Assistant: 2022.3.0 or later
- Home Assistant Core: 2025.10+ (with modernized features)
- Python: 3.9 or later
- Network: Receiver must be accessible via HTTP on your local network
- FIXED: Updated media browsing to use MediaClass instead of MediaType for proper Home Assistant standards compliance
- IMPROVED: NET RADIO browsing now uses MediaClass.DIRECTORY for folders and MediaClass.TRACK for stations
- IMPROVED: SERVER browsing now uses MediaClass.DIRECTORY/ALBUM for containers and MediaClass.TRACK for playable items
- ENHANCED: Intelligent media class selection - albums use MediaClass.ALBUM, other folders use MediaClass.DIRECTORY
- TECHNICAL: Follows Home Assistant's media player integration standards where MediaClass categorizes browsing hierarchy and MediaType identifies playback content type
- IMPROVED: Major code quality improvements with ~250 fewer lines
- REFACTORED: Eliminated duplicate XML parsing logic (saved ~135 lines)
- REFACTORED: Added helper methods for pagination and navigation controls
- REFACTORED: Created factory methods for cleaner BrowseMedia object creation
- CLEANED: Removed redundant debug logging for better performance
- TECHNICAL: Simplified navigation path management system
- TECHNICAL: Better code organization and maintainability
- NEW: Full SERVER media browsing support with folder navigation
- NEW: Pagination controls for large media libraries
- NEW: Back navigation and breadcrumb support
- IMPROVED: Enhanced media metadata display for SERVER content
- IMPROVED: Better error handling for network timeouts
- TECHNICAL: Modernized code for Home Assistant 2025.x compatibility
- IP Address Management: Change receiver IP address through Home Assistant UI without removing/re-adding integration
- Unique Entity ID: Added unique_id property for full UI management support
- Enhanced TUNER Controls: Preset navigation buttons now work even when frequency is not locked (weak signals)
- Performance Improvements: Eliminated duplicate API calls and optimized preset detection
- Code Modernization: Removed deprecated config_entry assignment warnings for Home Assistant 2025.12+ compatibility
- Code Cleanup: Streamlined codebase with better error handling and reduced logging overhead
- 🐛 Bug Fix: Fixed volume control mapping between Home Assistant and receiver
- 🔧 Volume Scaling: Corrected volume conversion to properly map 0-100% range
- ✅ TUNER Preset Support: Switch between 8 radio presets using next/previous track buttons
- ✅ Enhanced Media Information: Display station names, program info, and frequencies for TUNER source (e.g., "#4 RAADIO 2 • FKA TWIGS - Striptease_ (FM 101.6 MHz)")
- ✅ NET RADIO Browse Media: Browse and select internet radio stations directly in Home Assistant
- ✅ Fully Async Implementation: Complete conversion to async/await for better performance
- ✅ Improved API Communication: Better error handling and XML parsing
- ✅ Modern MediaType Support: Updated to use latest Home Assistant MediaType enum
- ✅ Config Flow Support: Easy setup through Home Assistant UI
- ✅ Connection Testing: Automatic validation during setup
- ✅ Modern APIs: Updated for Home Assistant 2025.10+ compatibility
- ✅ Async HTTP: Non-blocking HTTP calls in config flow
- ✅ Improved Error Handling: Better logging and error messages
- ✅ Code Modernization: English comments and updated architecture
- ✅ HACS Compatible: Easy installation through HACS custom repositories
- ✅ Better Documentation: Comprehensive README with multiple installation methods
Connection Issues:
- Ensure your receiver is on the same network as Home Assistant
- Check that the IP address is correct and accessible
- Verify the receiver's network settings are properly configured
Setup Problems:
- Try restarting Home Assistant after installation
- Check the Home Assistant logs for error messages
- Ensure no firewall is blocking HTTP requests to the receiver
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
This integration is not officially affiliated with Yamaha Corporation and is a community-driven project. Use at your own risk.