LiveStream

A simple LAN (Local Area Network) streaming application for sharing your screen and audio within the same network.

中文說明書 (README.zh-TW.md)

Features

• Screen sharing: Broadcast your desktop or specific windows
• Audio streaming: Share system audio along with video
• Web-based interface: View streams through any modern web browser
• Automatic discovery: Stream appears automatically for viewers on the same network
• Single executable: No installation required, just run and go

Installation

Download Pre-built Release (Recommended)

1. Go to the Releases page
2. Download the latest LiveStream.zip
3. Extract the ZIP file to any folder
4. Double-click StreamApp.exe to run

Build from Source

If you prefer to build from source:

dotnet publish -c Release

The compiled application will be in the Publish folder.

Quick Start

1. Start streaming

   • Double-click StreamApp.exe
   • The application will start automatically and open your browser
   • Click "Start Streaming" to begin broadcasting

2. View streams

   • Open any web browser on the same network
   • Go to http://[your-computer-ip]:8080
   • Or wait for automatic discovery (if enabled)

Requirements

• Windows 10/11
• Local network connection
• Modern web browser (Chrome, Firefox, Edge, Safari)

Usage

For Broadcasters

1. Run StreamApp.exe
2. The web interface opens automatically
3. Select what to share (entire screen or specific window)
4. Click "Start Streaming"
5. Share the URL with viewers on your network

For Viewers

1. Open your web browser
2. Navigate to the stream URL provided by the broadcaster
3. Watch the stream in real-time

Remote Access via VPN

To stream across different physical locations, use a VPN to create a virtual LAN:

• Tailscale: Install Tailscale on both broadcaster and viewer devices. Once connected, use the Tailscale IP address to access the stream.
• Hamachi: Create a Hamachi network and have both parties join. Use the Hamachi IP address for streaming.

This allows you to stream over the internet as if devices were on the same local network.

Technical Details

• Protocol: WebRTC for low-latency streaming
• Port: Default 8080 (configurable in appsettings.json)
• Network: Works on local LAN only
• Performance: Optimized for screen sharing with audio

Configuration

Edit appsettings.json to customize:

• Port number
• Network discovery settings
• Video quality settings

Troubleshooting

Stream not visible to others:

• Check firewall settings (port 8080)
• Ensure all devices are on the same network
• Verify the broadcaster's IP address

Poor quality:

• Check network bandwidth
• Reduce video quality in settings
• Close other network-intensive applications

Audio issues:

• Ensure audio permissions are granted
• Check system audio output settings
• Verify audio capture device is available

File Structure

Publish/
├── StreamApp.exe              # Main application
├── appsettings.json           # Configuration
├── Web/wwwroot/               # Web interface
└── ffmpeg-8.1-full_build-shared/  # Video encoding tools

Notes

• This application is designed for local network streaming only
• No internet connection required for streaming
• Multiple viewers can watch the same stream simultaneously
• Automatic cleanup of old instances on startup

License

Internal use only.