Watch Any Stream in VLC Without the Browser Bloat

// Before you start

What you need

Windows, macOS, or Linux computer
VLC media player installed (vlc.videolan.org)
Internet connection
Basic comfort opening a terminal or Command Prompt

Step 1 of 6

Install Streamlink

3 min

Streamlink has official installers for every platform. Pick the command that matches your OS and paste it into your terminal or Command Prompt. On Windows you can also download a standalone .exe installer from the GitHub releases page if you prefer not to use a package manager.

Terminal · mac

$ # Windows (winget)

$ winget install streamlink

$ # macOS (Homebrew)

$ brew install streamlink

$ # Linux (pip — works everywhere Python is installed)

$ pip install streamlink

What you should see

A line near the end that says something like 'Successfully installed streamlink-X.X.X' or 'streamlink X.X.X' after running 'streamlink --version'.

This might happen

pip install fails with a permissions error on Linux/macOS

Add --user to the command: pip install --user streamlink

Step 2 of 6

Confirm the install worked

1 min

Run one quick command to make sure Streamlink is on your PATH and ready to use. If this prints a version number, you are good to go.

Terminal · mac

$ streamlink --version

What you should see

streamlink 7.x.x (or whatever the current version is)

This might happen

'streamlink' is not recognized as a command on Windows

Close and reopen Command Prompt so the PATH update takes effect, then try again.

Step 3 of 6

Make sure VLC is installed and findable

2 min

Streamlink sends the video to VLC by default. VLC must be installed and, on Windows, its folder must be in your PATH — or you can tell Streamlink exactly where to find it. The easiest check is to open VLC normally; if it opens, Streamlink will usually find it automatically.

Terminal · mac

$ # Quick check — if this prints a path, VLC is findable

$ # macOS / Linux

$ which vlc

$ # Windows (in PowerShell)

$ Get-Command vlc

What you should see

A file path ending in 'vlc' or 'vlc.exe'. If you get 'not found', see the warning below.

This might happen

VLC is installed but not found by the command above

On Windows, add VLC's folder (e.g. C:\Program Files\VideoLAN\VLC) to your system PATH, or pass --player "C:\Program Files\VideoLAN\VLC\vlc.exe" in every Streamlink command.

Step 4 of 6

Stream a live channel at the best quality

1 min

Replace the URL below with any supported stream — a Twitch channel, a YouTube live stream, etc. The word 'best' tells Streamlink to pick the highest quality available. VLC will open automatically and start playing.

Terminal · mac

$ streamlink "https://www.twitch.tv/twitchpresents" best

What you should see

Lines like '[cli][info] Found matching plugin ...' then '[cli][info] Opening stream: ...' and VLC launches and begins playing.

This might happen

Stream opens but immediately stops or shows an error about no streams found

The channel may be offline. Try a channel you know is live, or check the Streamlink plugins page to confirm the site is supported.

Step 5 of 6

Choose a specific quality level

1 min

Instead of 'best' you can pick a specific resolution. Run the first command to list all available qualities for a stream, then run the second command substituting the quality name you want.

Terminal · mac

$ # Step 1 — list available qualities

$ streamlink "https://www.twitch.tv/twitchpresents"

$ # Step 2 — play a specific quality (e.g. 720p60)

$ streamlink "https://www.twitch.tv/twitchpresents" 720p60

What you should see

Step 1 prints a line like 'Available streams: audio_only, 160p, 360p, 480p, 720p60, 1080p60 (best)'. Step 2 opens VLC at that quality.

Step 6 of 6

Save a stream to a file instead of playing it

1 min

If you want to record the stream to disk rather than watch it live, add the -o flag followed by a filename. Streamlink will write the video file to your current folder.

Terminal · mac

$ streamlink -o my-recording.mp4 "https://www.twitch.tv/twitchpresents" best

What you should see

Terminal shows download progress. A file called my-recording.mp4 appears in the folder you ran the command from.

This might happen

The file grows but playback in VLC looks corrupted

Some streams use formats that need a .ts extension instead of .mp4. Try renaming the output file to my-recording.ts and playing that.

// Status

cooked. baked. worked.

A terminal command that opens any supported live stream directly in VLC at the quality you choose, with no browser required. Optionally, a saved video file on your hard drive.

// the honest bit

The honest part

Streamlink works great for most major platforms, but some sites (especially ones behind login walls or with heavy DRM like Netflix or Disney+) are not supported and never will be — that is intentional. Twitch subscriber-only streams require you to pass your Twitch OAuth token via --twitch-api-header, which involves a few extra steps not covered here. Quality options vary by site and stream; 'best' is always the safe default.