open-pip-cli

The CLI wraps the open‑pip library to launch macOS’s native picture‑in‑picture (PiP) player with a given video source. It accepts both local file paths and remote URLs, supporting common formats such as MP4, M4V, MOV and HLS playlists (m3u8). Formats like MKV and AVI are not currently handled.

Typical usage involves invoking the command with a video argument, but the tool also works with piped input, allowing integration with other command‑line utilities that resolve streaming URLs. Examples include feeding a YouTube URL obtained via the ytdl package or a Twitch stream URL from twitch‑url‑cli directly into open‑pip, which then opens the content in PiP.

The package is distributed via npm and can be installed globally with npm or yarn. It requires macOS Sierra (10.12) or later, where the native PiP player is available, and is considered stable for everyday use.