Streamdock

A minimal macOS menu-bar app that opens live streams in a media player via streamlink.

Requirements

• macOS 13 or later
• streamlink — brew install streamlink
• A media player (default: IINA)
• Swift command-line tools — xcode-select --install

Build

./build.sh

Produces Streamdock.app. Move it to /Applications or run it in place.

Usage

Click the menu-bar icon (▶) to open the popover. Type a channel name and press Open in IINA (or Return). Right-click the icon to quit.

Configuration

On first launch the app writes a default config to:

$XDG_CONFIG_HOME/streamdock/config.json   # or ~/.config/streamdock/config.json

{
  "player": "/Applications/IINA.app/Contents/MacOS/iina-cli",
  "player_args": "{playerinput}-stdin",
  "quality": "best",
  "url": "https://twitch.tv/%"
}

Key	Description
url	Stream URL template — % is replaced with the channel name
quality	Quality selector passed to streamlink (e.g. best, 720p)
player	Path to the player binary (supports ~/)
player_args	String passed to streamlink's --player-args
streamlink	Path to streamlink binary — omit to auto-detect

Edit the file and relaunch the app to pick up changes. If the config is invalid the popover shows an orange error and falls back to built-in defaults.

License

MIT