StreamGrid is a multi-stream viewer that gives you total control over how you watch. Build a giant main feed ringed by smaller cameras, a tidy equal grid for monitoring, or any arrangement in between — then drag, resize, and auto-fit it to your window in a click. Built with Electron, React, and TypeScript, it's the command center for watching many live sources at once.
git clone https://github.com/LordKnish/StreamGrid.git
cd StreamGrid
Install dependencies
bash
npm install
Run in development mode (for testing/development)
bash
npm run dev
Package the application (for distribution)
bash
npm run dist:win # Windows (NSIS installer)
npm run dist:mac:x64 # macOS (Intel)
npm run dist:mac:arm64 # macOS (Apple Silicon)
npm run dist:linux # Linux (AppImage + deb)
To produce an unpacked build for the current platform without an installer:
bash
npm run build:unpack
Find your built application in the dist/ directory, e.g.:
Windows: dist/streamgrid-3.0.0-win-x64.exe
macOS: dist/streamgrid-3.0.0-mac-*.dmg
Linux: dist/streamgrid-3.0.0-linux-x64.AppImage
RTSP Stream Support
StreamGrid supports RTSP (Real Time Streaming Protocol) streams from IP cameras, security systems, and other RTSP sources.
Requirements
FFmpeg must be installed on your system (see installation instructions above)
Window-filling auto-arrange — a rebuilt layout engine that picks the best row/column split for the current window and stretches every tile edge-to-edge, with no empty bands or letterboxing between feeds
Reliable grid management — fixed renaming in the All grids view, corrected grid duplication, and a redesigned, faster All grids browser with search
Import from the + menu — right-click the new-grid + button to import a shared grid; import is also available from the All grids view
Streamlined auto-arrange — the confirmation is now a simple prompt
Live status bar — shows FFmpeg readiness, the active grid, and feed count
Bug Fixes
Grids now stay in sync across the tab strip, quick switcher, and All grids view after rename/duplicate/delete/import
Layout calculations measure the real canvas, so feeds fit the window accurately
Version 2.0.0
Major Feature Release - Automation & Advanced Controls
New Features
REST API - Full programmatic control with authentication and rate limiting
M3U Playlist Import - Import playlists with intelligent auto-arrangement
RTSP Stream Support - Production-ready IP camera streaming with FFmpeg transcoding
Sound Management System - Global and per-stream audio controls
Auto-Start Streams - Automatically play all streams on launch
Auto-Restart Failed Streams - Automatic retry with exponential backoff