AirScript Local Install And Setup

Use this page as the single source of truth for live-room setup. GitHub Pages is a static preview; real audience syncing requires local installation on the presenter laptop.

Step 1: Install And Start Locally

  1. Install Node.js 18+ on the presenter laptop.
  2. From the project folder, run npm install.
  3. Start the relay with npm start.
  4. If port 8000 is busy, run PORT=4000 npm start.

Step 2: Open Speaker And Audience URLs

  1. Use the speaker URL opened by startup, or open https://localhost:8000/demo/speaker.html.
  2. Find your laptop LAN IP and share https://YOUR_LAN_IP:8000/demo/ with attendees.
  3. All audience devices must join the same network as the presenter laptop.

The first connection may show a certificate warning because local HTTPS uses a self-signed certificate by default.

Step 3: Run The Session

  1. Open speaker page in Chrome or Edge.
  2. Start captions and allow microphone access.
  3. Verify audience devices are receiving updates.

Need Network Help?

If venue Wi-Fi blocks device-to-device traffic, use the Mac Internet Sharing guide.

Open Mac Internet Sharing Guide