Usage Guide¶
This comprehensive guide will walk you through using Gazer Mobile Stream Studio to stream captured video content with camera overlay to RTMP endpoints.
Initial Setup¶
Hardware Requirements¶
Before starting, ensure you have the following hardware:
- Android Device: Must support USB Host mode (most devices Android 7.0+)
- USB Capture Card: Any UVC (USB Video Class) compatible device
- Examples: Elgato Cam Link, HDMI to USB adapters, generic capture cards
- USB Connection: USB-C to USB adapter if your device only has USB-C
- Video Source: HDMI output device (camera, gaming console, computer, etc.)
Software Setup¶
- Download and Install
- Download the latest APK from the GitHub releases page
- Enable "Install from Unknown Sources" in your Android settings
-
Install the APK file
-
Grant Permissions
- Camera: Required for overlay functionality
- Microphone: Needed for audio streaming
- USB Host: Essential for capture card connectivity
- Storage: For saving settings and temporary files
- Internet: Required for RTMP streaming
Getting Started¶
Step 1: Connect Your Hardware¶
- Connect Video Source: Plug your video source (camera, console, etc.) into the capture card via HDMI
- Connect Capture Card: Connect the USB capture card to your Android device
- Device Recognition: The app will automatically detect the USB device and prompt for permissions
- Grant USB Permission: Tap "OK" when prompted to allow USB access
Step 2: Configure Stream Settings¶
Basic Stream Configuration¶
- RTMP URL: Enter your streaming platform's RTMP server URL
- Twitch:
rtmp://live.twitch.tv/live/
- YouTube:
rtmp://a.rtmp.youtube.com/live2/
-
Facebook:
rtmps://live-api-s.facebook.com:443/rtmp/
-
Stream Key: Enter your unique stream key from your streaming platform
- Found in your streaming platform's dashboard
- Keep this key private and secure
Quality Settings¶
- Resolution
- 720p (1280x720): Good balance of quality and bandwidth
-
1080p (1920x1080): Higher quality, requires more bandwidth
-
Bitrate (500-8000 kbps)
- 1000-2000 kbps: Good for 720p streaming
- 2500-6000 kbps: Recommended for 1080p streaming
-
Higher bitrates: Better quality but require faster internet
-
Frame Rate
- 30 FPS: Standard for most content
- 60 FPS: Smooth motion, ideal for gaming
- 24 FPS: Cinematic look
- 15 FPS: Low bandwidth situations
Step 3: Configure Camera Overlay¶
Enabling the Overlay¶
- Toggle Camera: Tap the camera toggle switch to enable/disable overlay
- Position Adjustment: Drag the overlay to your desired position
- Resize: Use pinch gestures to resize the overlay
Overlay Settings¶
Access the overlay settings dialog by tapping the settings icon:
- Size Presets
- Small: 15% of screen width
- Medium: 25% of screen width
- Large: 35% of screen width
-
Custom: Manual size adjustment
-
Position Presets
- Top-Left: Upper left corner
- Top-Right: Upper right corner
- Bottom-Left: Lower left corner
- Bottom-Right: Lower right corner
Step 4: Start Streaming¶
- Preview Check: Verify your video preview looks correct
- Settings Review: Double-check your stream settings
- Start Stream: Tap the "Start Streaming" button
- Monitor Status: Watch the connection status indicator
- Go Live: Your stream is now broadcasting!
Advanced Features¶
Multiple Video Formats¶
The app automatically detects and handles various video formats: - YUV420: Standard uncompressed format - NV21: Android native format - JPEG/MJPEG: Compressed formats for some capture cards
Responsive Design¶
Phone Layout¶
- Compact vertical layout
- Essential controls easily accessible
- Optimized for one-handed operation
Tablet Layout¶
- Expanded horizontal layout
- Larger preview window
- More detailed control panels
- Better for monitoring streams
Performance Optimization¶
For Best Streaming Quality:¶
- Close Background Apps: Free up system resources
- Use Wired Internet: More stable than Wi-Fi when possible
- Optimal Lighting: Ensure good lighting for camera overlay
- Monitor Temperature: Prevent device overheating during long streams
Bitrate Recommendations by Resolution:¶
- 720p @ 30fps: 1500-4000 kbps
- 720p @ 60fps: 2250-6000 kbps
- 1080p @ 30fps: 3000-6000 kbps
- 1080p @ 60fps: 4500-9000 kbps
Troubleshooting¶
Common Issues¶
"USB Device Not Detected"¶
- Check USB Host Support: Ensure your device supports USB Host mode
- Try Different Ports: Some devices have specific USB port requirements
- Restart App: Close and reopen the application
- Device Compatibility: Verify your capture card is UVC compatible
"Streaming Connection Failed"¶
- Check Internet: Verify stable internet connection
- Verify RTMP URL: Ensure correct streaming server URL
- Check Stream Key: Confirm stream key is correct and active
- Firewall/Network: Check if network blocks RTMP traffic
- Reduce Bitrate: Try lower bitrate if connection is unstable
"Camera Overlay Not Working"¶
- Camera Permission: Verify camera permissions are granted
- Camera in Use: Ensure no other apps are using the camera
- Restart Camera: Toggle camera overlay off and on again
"Poor Video Quality"¶
- Increase Bitrate: Higher bitrate improves quality
- Check Source: Ensure input video quality is good
- Stable Connection: Verify internet connection stability
- Reduce Resolution: Try 720p if 1080p has issues
"App Crashes or Freezes"¶
- Restart App: Force close and restart the application
- Reduce Settings: Lower resolution, bitrate, or frame rate
- Free Memory: Close other apps to free up RAM
- Cool Down Device: Allow device to cool if overheating
Performance Tips¶
Streaming Optimization:¶
- Wired Connection: Use USB tethering or Ethernet when possible
- Power Management: Keep device plugged in during streaming
- Background Apps: Close unnecessary applications
- Network Priority: Ensure streaming app has network priority
Battery Life:¶
- Lower Brightness: Reduce screen brightness
- Disable Features: Turn off unnecessary phone features
- Power Saving: Use battery optimization settings
- External Power: Connect to charger for long streams
Platform-Specific Settings¶
Twitch¶
- RTMP URL:
rtmp://live.twitch.tv/live/
- Recommended Bitrate: 1000-6000 kbps
- Max Resolution: 1080p @ 60fps
YouTube Live¶
- RTMP URL:
rtmp://a.rtmp.youtube.com/live2/
- Recommended Bitrate: 1500-9000 kbps
- Max Resolution: 1080p @ 60fps
Facebook Live¶
- RTMP URL:
rtmps://live-api-s.facebook.com:443/rtmp/
- Recommended Bitrate: 1000-6000 kbps
- Max Resolution: 1080p @ 30fps
Best Practices¶
Content Creation¶
- Test Stream: Always do test streams before going live
- Backup Plan: Have alternative streaming setup ready
- Monitor Chat: Keep an eye on viewer feedback
- Audio Levels: Ensure proper audio levels throughout stream
Technical Setup¶
- Regular Updates: Keep the app updated to latest version
- Settings Backup: Note down your optimal settings
- Hardware Care: Keep USB connections secure during streaming
- Network Monitoring: Monitor internet speed during streams
Engagement¶
- Overlay Positioning: Position camera overlay to not block important content
- Lighting Setup: Ensure good lighting for camera overlay
- Audio Quality: Use external microphone for better audio if possible
- Interactive Elements: Use camera overlay for viewer interaction
Support and Community¶
If you encounter issues not covered in this guide:
- Check GitHub Issues: Search existing issues for solutions
- Create New Issue: Report bugs with detailed information
- Community Discussions: Join GitHub discussions for tips and help
- Update App: Ensure you're using the latest version
Remember to provide detailed information when seeking help: - Android device model and version - Capture card model - App version - Streaming platform - Error messages or symptoms - Steps that led to the issue