Install on macOS

The installer supports Intel (x86_64) and Apple silicon (arm64) Macs. It downloads the latest matching GitHub release by default and checks its SHA-256 checksum. Set OPENSTREAM_VERSION to a release such as 1.5.0 when you need to pin the installed version.

Install

Open Terminal and run:

curl -fsSL https://raw.githubusercontent.com/wpfyorg/openstream-tv/main/scripts/install.sh | sh

Without elevated privileges, the binary goes in $HOME/.local/bin. Add that directory to your shell’s PATH if needed. For example, with zsh:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Guided setup

In a terminal, the installer also asks how the server should be set up: build (full or slim), account (JioTV, JioTV+, or Fastway when that release supports it), the LAN address other devices will use, whether to expose it through Cloudflare, and the account sign-in. Arrow keys select, Enter confirms, and Ctrl-C cancels without leaving the terminal in a broken state.

The same settings can be supplied up front to skip the questions:

curl -fsSL https://raw.githubusercontent.com/wpfyorg/openstream-tv/main/scripts/install.sh | OPENSTREAM_VARIANT=slim OPENSTREAM_PROVIDER=jiotv OPENSTREAM_TUNNEL=none sh

OPENSTREAM_ONBOARD=never turns the flow off. Piping the script into sh is fine because prompts read /dev/tty, not the pipe; with no terminal the installer behaves exactly as it does without this option.

First run

The guided setup connects the account for you. If it printed a retry command that sources installer.env, use that exact command so the selected provider settings are loaded. If you skipped guided setup entirely, set the matching provider flags in the same shell before signing in and keep that shell open for serve:

# JioTV: mobile-number OTP
export OPENSTREAM_TVPLUS=false OPENSTREAM_FASTWAY=false
ost login otp

# JioTV+: eligible JioFiber or AirFiber login
export OPENSTREAM_TVPLUS=true OPENSTREAM_FASTWAY=false
ost tv+ login

# Fastway: prompts for the provider username and password
export OPENSTREAM_TVPLUS=false OPENSTREAM_FASTWAY=true
ost fastway login

Then protect and start the full web build:

ost admin password
ost serve --host 127.0.0.1 --tls

Open https://localhost:5443/ and accept the self-signed certificate warning. To access the server from other devices on your home network, bind to all interfaces with --host 0.0.0.0 and use your Mac’s LAN address. Keep access limited to a trusted network. The slim build has no browser interface.

For boot-time service setup, see Background service. For updates, see How to Update OpenStream TV; for removal, see Uninstall OpenStream TV Safely.

Verify and troubleshoot

Run command -v ost and ost --help in Terminal. Confirm the browser opens the address selected when starting serve. If ost is missing, confirm your install location is in PATH; restart Terminal after updating the shell profile. If a port is occupied, follow startup fixes.

Update with ost update, restart OpenStream TV, and check the interface. For removal, stop OpenStream TV and delete the binary from your install directory. Keep your data directory unless you want to erase your saved account state; see uninstall.