A Chrome extension that combines radio streaming with Matrix chat integration for Disruptarian Radio.
- Multi-stream Support: Add up to 5 radio streams
- SonicPanel Integration: Automatic metadata display (now playing, cover image, listeners, DJ, last 20 songs)
- Audio Visualizer: Real-time audio visualization
- Volume Control: Adjustable volume with persistence
- Background Playback: Audio continues playing when navigating between pages
- Stream Management: Easy addition and configuration of radio streams
- Decentralized Chat: Connect to any Matrix homeserver
- Real-time Messaging: 1-second refresh interval for near real-time message delivery
- Room Management: Join public and private Matrix rooms
- Recommended Rooms: Quick access to popular Matrix rooms
- Cross-platform: Works with all Matrix clients
- End-to-End Encryption: Secure messaging support
- Dark Theme: Modern, card-based dark UI
- Side Panel: Clean, organized interface
- Responsive Design: Works on all screen sizes
- Navigation: Easy switching between Radio, Chat, and Options
- Visit the Chrome Web Store
- Search for "Airwave Automator Free"
- Click "Add to Chrome"
- Confirm installation
- Download or clone this repository
- Open Chrome and go to
chrome://extensions/ - Enable "Developer mode" in the top right
- Click "Load unpacked" and select the extension folder
- The extension will be installed and ready to use
- Click the extension icon in your toolbar
- Select "Radio" to open the radio player
- Choose a stream from the dropdown
- Click the play button to start streaming
- Adjust volume using the slider
- Add new streams via the "Options" button
- Go to the "Options" page
- Select a Matrix homeserver from the dropdown
- Enter your Matrix credentials (@user:server and password)
- Click "Login to Matrix"
- Go to the "Chat" page
- Click on any recommended room to join
- Start chatting!
- Click "Options" from the Radio page
- In the "Stream Configuration" section:
- Name: Display name for the stream
- URL: Stream URL (HTTP/HTTPS)
- Port: Stream port number
- API URL: Optional SonicPanel API URL
- Click "Add Stream" to save
- Click "Save All" to persist changes
- Go to the Options page
- In the "Matrix Chat Configuration" section:
- Homeserver: Select from dropdown or enter custom URL
- Username: Your Matrix user ID (@user:server)
- Password: Your Matrix password
- Refresh Interval: How often to check for new messages (1-60 seconds)
- Shoutcast: Standard Shoutcast streams
- Icecast: Icecast streaming servers
- SonicPanel: Enhanced metadata support
- HTTP/HTTPS: Direct audio stream URLs
The extension supports the following popular Matrix homeservers:
- matrix.org (Official)
- tchncs.de
- envs.net
- g24.at
- gemeinsam.jetzt
- glasgow.social
- gnulinux.club
- grin.hu
- hot-chilli.im
- imagisphe.re
- #matrix:matrix.org - Official Matrix room
- #general:matrix.org - General discussion
- #help:matrix.org - Help and support
- #airwavesupport:matrix.org - Plugin Support From AirwaveAutomator
- #disruptiverequests:matrix.org - Radio Chatbot Demonstration
- Support User: @disruptarianradio:matrix.org
- Server: matrix.org
- Channel: #airwavesupport:matrix.org
- Toll Free: +1 (888) 264-6790
- Website: spunwebtechnology.com
- Email: support@spunwebtechnology.com
- Decentralized: No single point of failure
- End-to-End Encryption: Secure messaging
- Cross-Platform: Works on all devices
- Room Types: Public, private, and encrypted rooms
- File Sharing: Images, documents, and more
Q: What is Airwave Automator Free? A: It's a Chrome extension that combines radio streaming with Matrix chat integration, allowing you to listen to radio streams while chatting with others in Matrix rooms.
Q: Is this extension free? A: Yes, Airwave Automator Free is completely free to use with no limitations.
Q: What browsers are supported? A: Currently, only Chrome and Chromium-based browsers are supported (Chrome, Edge, Brave, etc.).
Q: How many radio streams can I add? A: You can add up to 5 radio streams in the extension.
Q: What audio formats are supported? A: The extension supports standard streaming audio formats including MP3, AAC, OGG, and other formats supported by HTML5 audio.
Q: Why isn't my stream playing? A: Check that:
- The stream URL is correct and accessible
- The stream is not geo-blocked
- Your internet connection is stable
- The stream format is supported
Q: Can I listen to radio while browsing other websites? A: Yes! The audio continues playing in the background even when you navigate away from the extension or close the side panel.
Q: How do I add metadata to my stream? A: Use SonicPanel or provide an API URL in the stream configuration. The extension will automatically fetch and display metadata.
Q: What is Matrix? A: Matrix is a decentralized, open-source communication protocol that enables secure, real-time messaging across different platforms and servers.
Q: Do I need a Matrix account? A: Yes, you need a Matrix account to use the chat features. You can create one on any Matrix homeserver.
Q: Can I use any Matrix homeserver? A: Yes, you can use any Matrix homeserver. The extension includes popular options, but you can also enter a custom homeserver URL.
Q: Why are messages delayed? A: Messages are refreshed every 1 second by default. Some delay may occur due to Matrix server response times, but it should be minimal.
Q: Can I join private rooms? A: Yes, you can join any Matrix room you have access to, including private and encrypted rooms.
Q: How do I create a Matrix account? A: Visit any Matrix homeserver (like matrix.org) and click "Create Account" or "Sign Up" to register.
Q: What if I forget my Matrix password? A: You'll need to reset your password through your Matrix homeserver's web interface or contact your homeserver administrator.
Q: The extension isn't loading properly. What should I do? A: Try:
- Reloading the extension in
chrome://extensions/ - Refreshing the page
- Restarting Chrome
- Reinstalling the extension
Q: Audio stops playing when I switch pages. A: This shouldn't happen with the current version. If it does, try:
- Refreshing the extension
- Checking your Chrome audio settings
- Ensuring no other applications are interfering with audio
Q: Matrix login fails. What's wrong? A: Check that:
- Your username includes the full Matrix ID (@user:server)
- Your password is correct
- The homeserver URL is accessible
- Your internet connection is stable
Q: Messages aren't appearing in chat. A: Try:
- Clicking "Refresh Current Room"
- Using "Force Fresh Sync"
- Checking your Matrix connection status
- Verifying you're in the correct room
Q: Can I change the refresh interval? A: Yes, go to Options > Matrix Chat Configuration and adjust the "Chat Refresh Interval" (1-60 seconds).
Q: Is my data secure? A: Yes, the extension uses Chrome's secure storage for settings and Matrix's end-to-end encryption for messages.
Q: Does the extension collect personal data? A: No, the extension doesn't collect or transmit personal data. All settings are stored locally in your browser.
Q: Are my Matrix messages encrypted? A: Yes, Matrix supports end-to-end encryption. Enable it in your Matrix client for maximum security.
Q: The extension crashes when I click buttons. A: This usually indicates a JavaScript error. Check the browser console (F12) for error messages and try reloading the extension.
Q: I can't hear audio from the radio streams. A: Check:
- Your system volume is up
- Chrome isn't muted
- The stream URL is working
- No ad blockers are interfering
Q: Matrix rooms aren't loading. A: Try:
- Logging out and back in
- Checking your internet connection
- Verifying the homeserver is accessible
- Using a different homeserver
Q: How do I report bugs or request features? A: Contact us through:
- Matrix: #airwavesupport:matrix.org
- Email: support@spunwebtechnology.com
- Website: spunwebtechnology.com
- Clone the repository
- No build process required - it's a standard Chrome extension
- Load the extension in Chrome developer mode
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
├── manifest.json # Extension manifest
├── background.js # Service worker
├── radio.html # Radio player page
├── radio.js # Radio player logic
├── matrix.html # Matrix chat page
├── matrix.js # Matrix chat logic
├── options.html # Options/settings page
├── options.js # Options logic
├── popup.html # Extension popup
├── popup.js # Popup logic
├── styles.css # Global styles
├── assets/ # Images and icons
└── third_party/ # External libraries
├── matrix/ # Matrix SDK
└── sonic-widget.min.js
This project is licensed under the MIT License - see the LICENSE file for details.
- Added comprehensive Matrix Chat Information section
- Added recommended rooms as clickable options
- Improved user experience with better room discovery
- Enhanced support information display
- Optimized message delivery speed (1-second refresh)
- Added sync token handling for incremental updates
- Improved Matrix sync performance
- Added Force Fresh Sync functionality
- Fixed real-time message updates
- Enhanced Matrix sync mechanism
- Added duplicate event detection
- Improved error handling
- Fixed missing Join Room button
- Added fallback room list initialization
- Enhanced room list rendering
- Improved Matrix client stability
- Added debugging tools for timeline issues
- Enhanced Matrix event handling
- Improved message display mechanism
- Added test message functionality
- Matrix.org for the Matrix protocol and SDK
- SonicPanel for metadata integration
- Chrome Extensions API for the platform
- Disruptarian Radio for inspiration and testing
Made with ❤️ by SpunWeb Technology
For support, visit spunwebtechnology.com or join us on Matrix at #airwavesupport:matrix.org