Direct answer
Place an IPv6 literal in square brackets before the port, for example rtsp://[2001:db8::20]:554/path. A link-local address may also require an interface scope that the client must support.
Why this happens
Colons are part of an IPv6 address and would be confused with the port delimiter without brackets. Even a correctly formatted URI can fail if the address is link-local, the route is missing or the camera service listens only on IPv4.
Treat the URL, credentials, address family and RTP transport as separate variables that can fail independently.
A controlled test
Verify IPv6 reachability outside the viewer, then test the RTSP port and finally the media path. Keep an IPv4 baseline when the camera supports both.
Change one variable at a time. Keep the camera model, firmware, endpoint and account recorded; then test network reachability, protocol response, media transport and decoding as separate layers.
Use a dedicated view-only account and a trusted local diagnostic tool. Redact credentials, private addresses and identifying data before sharing output.
Diagnostic sequence
| Check | Action | Evidence of progress |
|---|---|---|
| Format | Wrap the IPv6 literal in square brackets. | The client parses the address and port separately. |
| Scope | Identify whether the address is global, ULA or link-local. | The viewer uses the correct interface and route. |
| Service | Confirm RTSP listens on IPv6, not only IPv4. | A protocol response arrives on the target address. |
| VPN | Verify the remote tunnel carries the IPv6 prefix. | The camera route exists away from the LAN. |
Evidence to keep
Capture the address type, interface, route and RTSP response with credentials removed. That separates URI syntax from network reachability.
Boundary and safety note
Do not publish real globally reachable camera addresses or open RTSP directly to the public IPv6 internet.
For remote viewing, use a managed VPN instead of exposing RTSP or camera administration ports directly to the public internet.
SmartRTSP
SmartRTSP is a camera-focused RTSP and ONVIF viewer for Apple devices, Windows and Android. It fits direct viewing, discovery and multi-camera checks; keep a dedicated NVR or VMS when continuous recording, evidence export or centralized enterprise controls are required.
Frequently asked questions
Why are brackets required around IPv6 in an RTSP URL?
They distinguish the colons inside the address from the colon before the port.
Will an IPv4-only camera accept an IPv6 URL?
No. The device and network path must both support IPv6.
Why does a link-local URL work only on one device?
Link-local addresses depend on the local interface scope and do not route normally across networks.
Primary references
Related SmartRTSP guide
Open related guideBuild an RTSP URI for an IPv6 literal and diagnose link-local scope or VPN routing issues.