WINK Media Bridge

RTSP to HLS Gateway | April 2023

Point it at an RTSP camera, open your browser, watch the video.

A simple tool for testing RTSP camera connectivity. Connects to any RTSP source and serves an HLS stream with a built-in browser player. No ffmpeg installation, no configuration files, no dependencies.

./wink-media-bridge --rtsp rtsp://admin:password@192.168.1.100:554/stream

# Open http://localhost:8000 in your browser

Downloads

Windows	x64 | ARM64
macOS	Intel | Apple Silicon
Linux	x64 | ARM64

~11 MB per binary. macOS/Linux: run chmod +x after download.

Command Line Options

Flag	Default	Description
--rtsp	required	RTSP URL
--user		Username (if not in URL)
--pass		Password (if not in URL)
--listen	:8000	HTTP server address
--transport	tcp	tcp, udp, or auto
--timeout	10s	Connection timeout
--reconnect	true	Auto-reconnect on disconnect
--segment-duration	2s	HLS segment length
--playlist-size	3	Segments in playlist
--log-level	info	debug, info, warn, error

HTTP Endpoints

GET /	Browser player (hls.js)
GET /hls/index.m3u8	HLS master playlist
GET /hls/video1_stream.m3u8	Video playlist
GET /api/status	JSON status

Exit Codes

Useful for scripting and CI/CD:

0	Clean shutdown
1	General error
2	Auth failed (401)
3	Connection refused
4	Connection timeout
5	Unsupported codec (H.265)
6	HLS muxer error
7	HTTP port in use

Requirements

H.264 video codec only. H.265/HEVC is not supported. Most IP cameras default to H.264, but check your camera settings if you get codec errors.

Common RTSP URLs

# Hikvision
rtsp://user:pass@IP:554/Streaming/Channels/101

# Dahua / Amcrest
rtsp://user:pass@IP:554/cam/realmonitor?channel=1&subtype=0

# Reolink
rtsp://user:pass@IP:554/

# Axis
rtsp://user:pass@IP/axis-media/media.amp

# Generic ONVIF
rtsp://user:pass@IP:554/stream1

License: CC BY-NC-ND 4.0. Testing tool only, provided "as is" without warranty. Use at your own risk.

Full documentation | All tools