User manual

1 Introduction

A live stream always plays a few seconds behind what the streamer is doing right now. That gap grows every time your connection hiccups, and it never shrinks on its own.

Slipstream Live measures how much video your browser has loaded ahead — the buffer — about 50 times per second, and nudges the playback speed up or down to close the gap without letting the video stall.

Once installed, no operation is required while you watch.

2 System requirements

3 Installation

3.1 Chrome / Edge / Brave / other Chromium browsers

Install from the Chrome Web Store.

After installing, open the puzzle-piece menu in the toolbar and pin Slipstream Live so its icon is always visible.

3.2 Firefox

Install from Firefox Add-ons.

3.3 Installing from source (developers / manual installation)

Chromium browsers

1. Download the repository as a ZIP and extract it (or git clone it).
2. Enter chrome://extensions in the address bar.
3. Turn on Developer mode with the toggle in the top-right corner.
4. Click Load unpacked and select the extracted folder — the one containing manifest.json.

Firefox — temporary install (disappears when Firefox closes)

1. Open about:debugging#/runtime/this-firefox.
2. Click Load Temporary Add-on….
3. Select the manifest.json file inside the extracted folder.

Firefox — permanent install (Developer Edition / Nightly only)

1. ZIP the contents of the folder.
2. In about:config, set xpinstall.signatures.required to false.
3. In about:addons, click the gear icon → Install Add-on From File… → choose your ZIP.

3.4 Verifying the installation

1. Open a live stream on YouTube, Twitch, or TwitCasting. A VOD or clip will not work.
2. Click the Slipstream Live toolbar icon.
3. In the All sites panel, turn on Show playback rate.
4. A small 1.00x appears in the player's control bar, changing colour as Slipstream Live works.

4 Parts of the settings screen

Click the toolbar icon to open the settings popup. The same screen can also be opened as a full tab from your browser's extensions management page (Options).

• Changes take effect immediately. There is no Save button.
• Rows that are not currently in use are greyed out. For example, Speed-up buffer threshold (sec) is disabled while Auto-adjust buffer threshold is set to Standard or Aggressive.
• On the Twitch tab only, an explanatory note about that site's larger default threshold appears at the bottom of the panel.

5 Reading the on-screen badges

All three badges are off by default. Turn them on in the All sites panel. They appear in the player's control bar; if that bar cannot be found, they fall back to a small dark strip in the top-left corner of the player.

6 The three control modes

Higher-priority modes always win. The 0.15x floor speed is deliberately not configurable — it is a safety net, not a preference.

Each threshold carries hysteresis in the direction of the current mode, so speed and volume don't chatter when the buffer sits exactly on a boundary. The width follows the Auto-adjust buffer threshold level: 0.1 s at Off and Standard, 0.05 s at Aggressive.

What Slipstream Live leaves alone

• Archived videos (VODs), clips, and ad breaks are never touched. Only live playback is controlled.
• TwitCasting low-latency streams are out of scope. They arrive over WebRTC, which has no read-ahead buffer to measure and ignores playback-rate changes entirely. Such streams are already close to real time, so there is nothing to catch up on.
• On YouTube and TwitCasting, if you choose a speed other than 1.00x in the player's own menu, Slipstream Live hands control back to you and stops adjusting. Set the speed back to normal to resume automatic control. Twitch has no such menu, so Slipstream Live stays in charge there — and also suppresses Twitch's own built-in catch-up so the two don't fight.

7 Settings reference

7.1 Site settings (stored separately per site)

FF = the default used on Firefox, which reports buffer levels differently. Note the direction is not uniform: the Firefox defaults are larger on YouTube and TwitCasting, but smaller on Twitch.

7.2 The three auto-adjust levels

7.3 All-sites settings

8 How it works

Every 20 milliseconds Slipstream Live measures buffer health — how many seconds of video are loaded and ready to play — and picks one of the three modes from that number.

The hard part is knowing when speeding up is safe. Buffer health is never steady: video arrives in chunks ("segments"), so the buffer jumps when a chunk lands and then drains until the next one. Plotted over time it looks like a sawtooth. A single reading taken at a peak would suggest plenty of room, leading to a speed-up that hits the very next trough with nothing left.

So instead of trusting one reading, Slipstream Live estimates statistically where the troughs are, over a window that adapts to each stream, and only allows a speed-up while that estimated headroom stays above the buffer level you have asked it to protect. Because the safety factor is large, headroom only opens up when the troughs are consistent — an unstable connection naturally suppresses speed-ups, and while there isn't enough data yet, Slipstream Live simply does nothing.

One shortcut sits above that test. Once buffer health passes 20 seconds — or your maximum slowdown threshold plus 10 seconds, whichever is higher — the trough estimate is no longer what limits the decision, so Slipstream Live speeds up without waiting for it, and returns to the statistical test below 15 seconds. This is what keeps it responsive right after you seek, when the buffer refills so quickly that the statistics are temporarily unusable. The shortcut applies to the automatic levels only.

Badges are redrawn at most 10 times per second and all statistics are smoothed, so the speed does not visibly oscillate. When there is nothing to control, the loop drops to a 1-second search mode and then stops entirely, waking on media events or when the tab becomes visible again.

9 Troubleshooting

10 Collecting a debug log

If you need to report a problem, a debug log makes it far easier to diagnose.

1. Open the stream page and press F12 to open the browser console — the page console, not the extension's own console.
2. Run the line below.
3. Wait about 30 seconds while the problem is happening, then copy the output.

Once per second you will see the current mode, the real playback rate, buffer health, the short-term and trough statistics, the room calculation, the shortcut level ample, the accumulated excess consumption drift, and the stationarity verdict calm.

• Buffer figures shown as ---- mean the value is unavailable, usually because the browser reports an empty buffer.
• A persistent calm=NO means the stationarity gate is rejecting samples, so room stays ---- as well. A speed-up can still happen while buffer health is above ample.
• timer stopped appears often even when everything is working — content scripts run in every frame, and frames without a video element shut down after 5 seconds.

11 Privacy

Slipstream Live makes no network requests whatsoever. It requests only two permissions:

• storage — to save your settings locally on your device.
• activeTab — to see which supported site the popup was opened on, so it can select the right tab.

No analytics, no telemetry, no identifiers, no ads. Full details are in the privacy policy.

12 Support

When reporting a bug, please include: the site, browser and version, extension version, OS, what happened, steps to reproduce, any settings changed from the defaults, and a debug log if possible.

13 License

Dual-licensed under the Apache License 2.0 or the MIT License, at your option.