🎧 Win Stream Audio

Professional Windows audio streaming to Android devices over WiFi

Stream your Windows system audio (music, videos, games, calls) to your Android phone with professional audio controls, EQ, pitch shifting, and effects - all in real-time!

✨ Features

• 🎵 Stream all Windows system audio to Android devices
• 🎛️ Professional AudioPilot interface with cockpit-style controls
• 🎚️ 3-band EQ (Bass, Mid, Treble) with real-time adjustment
• 🎵 Pitch shifting with voice presets (Male, Female, Child, Robot)
• 🎭 Audio effects (Reverb, Echo, Distortion, Chorus)
• 📊 Real-time audio visualization with waveform and VU meters
• 📱 Screen wake system to prevent Android sleep
• 🔄 Auto-reconnection with seamless audio resumption
• 🌐 Works over internet with ngrok/localtunnel support
• 🎮 Perfect for gaming, music, videos, and calls

🚀 Quick Start

Using NPX (Recommended)

npx win-stream-audio

The CLI will prompt you for:

• Port number (default: 8080)
• Auto-open browser (default: yes)

Manual Installation

npm install -g win-stream-audio
win-stream-audio

📋 Setup Instructions

1. Enable Windows Stereo Mix (Required)

This is crucial for streaming system audio!

1. Right-click speaker icon → "Open Sound settings"
2. Click "Sound Control Panel" → "Recording" tab
3. Right-click empty space → "Show Disabled Devices"
4. Find "Stereo Mix" → Right-click → "Enable"
5. Right-click "Stereo Mix" → "Set as Default Device"

2. Start Streaming

1. On PC: Run npx win-stream-audio
2. On PC: Open the "PC Audio Source" URL and select "Stereo Mix"
3. On Android: Open the "AudioPilot Receiver" URL
4. On Android: Click "🔗 Establish Link" and enjoy!

🎛️ AudioPilot Professional Interface

System Controls

• 🔗 Establish Link - Connect to PC audio stream
• 📱 Screen Lock - Keep Android screen awake
• ⚡ Low Latency - Reduce audio delay (2-chunk buffer)
• 🌐 Internet Mode - Optimize for internet streaming (10-chunk buffer)
• 🎛️ Audio Filter - Enable/disable noise reduction

Audio Processing

• 🎚️ 3-Band EQ: Bass (80Hz), Mid (1kHz), Treble (8kHz)
• 🎵 Pitch Control: -1200 to +1200 cents with presets
• 🎭 Audio Effects: Professional reverb, echo, distortion, chorus
• 🔊 Master Volume: Rotary knob control

Voice Presets

• ♂️ Male: -200 cents (deeper voice)
• ♀️ Female: +300 cents (higher voice)
• 👶 Child: +600 cents (much higher)
• 🤖 Robot: -800 cents (very deep/robotic)

🌐 URLs and Access

When you run the command, you'll get:

📱 Main Interface: http://YOUR_IP:8080
🎤 PC Audio Source: http://YOUR_IP:8080/simple-source.html
🎧 AudioPilot Receiver: http://YOUR_IP:8080/audiopilot.html

🔧 Troubleshooting

Common Issues

❌ "No Stereo Mix option"

• Update your audio drivers
• Some laptops/PCs don't have this feature
• Use Virtual Audio Cable as alternative

❌ No sound on Android

• Ensure Stereo Mix is set as default recording device
• Check Android volume and browser audio permissions
• Make sure PC is actually playing audio

❌ Connection issues

• Ensure both devices are on same WiFi network
• Check Windows Firewall settings
• Try using localhost on PC instead of IP address

❌ High latency

• Use 5GHz WiFi if available
• Enable "Low Latency Mode" on Android
• Close other network-intensive applications

🌐 Internet Streaming

To stream over the internet:

1. Install ngrok: npm install -g ngrok
2. Start win-stream-audio: npx win-stream-audio
3. In another terminal: ngrok http 8080
4. Use the HTTPS URL provided by ngrok

🎯 Use Cases

• 🎮 Gaming: Hear PC game audio on your phone while gaming
• 🎵 Music: Use your phone as a wireless speaker
• 🎬 Videos: Watch PC videos with audio on your phone
• 💬 Calls: Route PC call audio to your phone
• 🔊 Presentations: Wireless audio for presentations
• 🎙️ Voice changing: Real-time voice effects for streaming

🛠️ Technical Details

• Audio Format: Raw PCM audio (48kHz stereo)
• Latency: ~200-600ms depending on network and settings
• Protocol: WebSocket for real-time streaming
• Compatibility: Windows 10/11, Android 6+
• Network: Works on local WiFi and internet

📱 Android Setup

1. Connect to same WiFi as PC
2. Open browser (Chrome recommended)
3. Navigate to the AudioPilot URL
4. Allow audio autoplay if prompted
5. Click "🔗 Establish Link" and connect

🔒 Security Notes

• Only works on local network by default
• No internet connection required for local use
• Audio data stays on your local network
• No data is stored or transmitted externally

🆘 Getting Help

1. Check Setup: Ensure Stereo Mix is enabled and set as default
2. Test Connection: Visit /status endpoint to check server status
3. Use Localhost: Try localhost:8080 on PC instead of IP
4. Check Firewall: Ensure Windows Firewall allows the connection

📄 License

MIT License - Feel free to use and modify!

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🎉 Enjoy streaming your PC audio to your Android phone wirelessly with professional controls!