📺 DualZ Stream Player

User Guide & Help Documentation

Version 1.0.1 | Last Updated: December 30, 2025

📑 Table of Contents

📱 What is DualZ Stream Player?

DualZ Stream Player is a specialized video streaming application designed to view HLS video streams with support for multi-camera mosaic grids. The app allows you to view a 2×2 camera grid and switch between individual camera views or view all cameras simultaneously.

🚀 Getting Started

Opening Streams

There are three ways to open a stream in DualZ Stream Player:

1. QR Code Scanning (Recommended)

2. Deep Links

Click or tap on a dualz:// link from:

Example: dualz://MzQuMjQxLjYuMTM3OjQ=

3. Universal Links

Click on an https://dualz.com/s/ or https://dualz.com/stream/ link:

Example: https://dualz.com/s/MzQuMjQxLjYuMTM3OjQ=

4. Manual Entry

  1. Tap the ☰ menu (hamburger icon) in the top-right corner
  2. Tap Settings
  3. Enter a stream URL in one of these formats:
    • dualz://base64encodeddata
    • https://dualz.com/s/base64encodeddata
    • Direct HLS URL: http://ip-address:8892/mosaic/index.m3u8
  4. Tap Apply

📹 Camera Controls

When Camera Buttons Are Visible

Camera buttons appear only when:

Link formats that show camera buttons:

Camera Button Layout

When visible, you'll see 5 buttons:

Button View Description
1 Camera 1 Top-left camera (zoomed)
2 Camera 2 Top-right camera (zoomed)
3 Camera 3 Bottom-left camera (zoomed)
4 Camera 4 Bottom-right camera (zoomed)
All Full Grid View all 4 cameras at once

How Camera Views Work

⚙️ Settings Menu

Access settings by tapping the icon in the top-right corner.

Available Options

Stream Configuration

App Information

Deep Link Format

New Format (Full URL):

dualz://BASE64_ENCODED_FULL_URL

Example:

dualz://aHR0cDovLzE4LjE5NC40Ljc5L2hscy9pbmRleC5tM3U4P3RpbGU9NA==

Decodes to: http://18.194.4.79/hls/index.m3u8?tile=4

The ?tile=4 parameter triggers the camera button display.

Old Format (IP:tiles):

dualz://BASE64_ENCODED_IP_TILES

Example:

dualz://MzQuMjQxLjYuMTM3OjQ=

Decodes to: 34.241.6.137:4

Universal Link Format

https://dualz.com/s/BASE64_ENCODED_DATA
https://dualz.com/stream/BASE64_ENCODED_DATA

Example:

https://dualz.com/s/MzQuMjQxLjYuMTM3OjQ=

Direct HLS Stream

http://IP_ADDRESS/path/to/stream.m3u8
http://IP_ADDRESS/path/to/stream.m3u8?tile=4

Example (without camera buttons):

http://34.241.6.137:8892/mosaic/index.m3u8

Example (with camera buttons):

http://18.194.4.79/hls/index.m3u8?tile=4
New: Direct HLS URLs with ?tile=4 parameter will show camera buttons!

🛠️ Troubleshooting

Stream Not Loading

Black Screen or Loading Forever

Solutions:
  1. Check your internet connection
  2. Verify the stream server is online
  3. Try entering the stream URL manually in Settings
  4. Ensure you're on the same network as the stream (if applicable)

Camera Buttons Not Appearing

"I can see the stream but no camera buttons"

Possible Causes:
  1. The URL doesn't contain ?tile=4 parameter
  2. Old format link without :4 tiles parameter
  3. The tiles value is not 4 (only 2×2 grids show camera buttons)
Solution:

Universal Link Opens Browser Instead of App

"The link opens Safari instead of the app"

This is normal iOS behavior:

Links from other apps work better:

App Shows "Unmatched Route"

"I see 'Unmatched Route' error"

Cause: You have an old version of the app without Universal Link support

Solution:
  1. Delete the app from your iPhone
  2. Restart your iPhone
  3. Install the latest version from TestFlight or App Store
  4. Try the link again

🔒 Privacy & Security

Data Collection

DualZ Stream Player does NOT collect any personal data:

Data Storage

Video Streams

View Full Privacy Policy →

📞 Support & Contact

Need Help?

Email Support:
support@dualz.com

Developer:
Dualz Solutions BV

Feedback & Feature Requests

We welcome your feedback! Contact us at support@dualz.com with: