Interactive User Guide

Learn how to navigate and utilize the OneSignal platform.

Viewing Livestreams

The main dashboard displays all livestream groups you have access to. Here's how to interact with them:

  • Navigate to the Dashboard
    Click on "Livestreams" in the left sidebar to view all available streams. Streams are organized by groups (e.g., TV Streams, Radio Streams).
  • Select a Stream
    Click on any stream card to open the detailed player view. You can see the stream's current status (Active/Offline) directly on the card.
  • Watch the Stream
    On the details page, the stream will begin playing automatically. Use the quality selector (gear icon) in the player controls to adjust the video resolution based on your connection.
Live Clipping Tool

The Live Clipping tool allows you to extract segments from a live stream instantly.

  • Open the Clipping Tool
    From a stream's details page, click the orange "Live Clipping" button.
  • Set Mark In & Mark Out Points
    Use the playback controls or the timeline ruler to find the start of your clip. Then:
    1. Press "I" on your keyboard to set the Mark In (Start) point.
    2. Find the end of your clip and press "O" to set the Mark Out (End) point.
    Alternatively, you can manually type times into the input boxes.
  • Fine-tuning (Nudging)
    Use the arrow buttons next to the time inputs, or the Left/Right arrow keys on your keyboard, to nudge the selection frame-by-frame for precise clipping.
  • Save the Clip
    Enter a title for your clip in the top right corner and click "Save Clip". The clip will appear in the "Recent Clips" list below.
  • Download or Process to VOD
    Once the clip's status changes to "ready", use the action buttons to preview it, download the MP4 file, or send it to the VOD processing queue.
Pro Tip: Keyboard Shortcuts
Use Spacebar to play/pause. Use SHIFT + Arrow Keys to jump 1 second forward or backward.
Global Settings & Audit Trail

The Administration dashboard allows you to configure system-wide settings and monitor user activity.

  • Access Administration
    Click on "Administration" in the left sidebar.
  • Configure Global Settings
    In the "Global Configuration" block, you can adjust settings like the default OBS sync directory or disable the UI feature flag. Click "Save Configuration" to apply changes globally.
  • View Audit Trail
    Scroll down to the "Audit Trail" section. Here you can see a chronological log of all system changes (logins, stream updates, branding changes).
  • Search & Filter Logs
    Use the search bar to find specific actions by username or details, and use the dropdowns to filter by resource type (e.g., stream, logo, user) or action type.
Managing Users & Access

Admins can create new users, reset passwords, and assign access to specific streams.

  • User Management Dashboard
    Navigate to "User Management" from the sidebar to view all registered users.
  • Create a New User
    Click "Add User". Define their username, email, and role (User vs. Admin). You can opt to have the system generate a secure password and send an invite link automatically.
  • Manage Stream Access
    Find a user in the list and click the "Manage Access" (key icon) button. Check the boxes next to the streams this user should be allowed to view and clip.
Stream Branding (Logos)

Admins can dynamically overlay logos/watermarks directly onto the live stream output.

  • Open Branding Settings
    From a stream's detail page, click the "Brand Stream" button.
  • Upload a Logo
    Use the uploader on the left side to add a transparent PNG file to the asset library.
  • Configure Logo Display
    Select the logo from the library. Choose its position (e.g., Top Right), adjust the size percentage, and set its opacity. This configuration is unique per stream.
  • Enable Branding
    Toggle the central switch to enable or disable the logo overlay in real-time. Changes are applied instantly to the backend transcoder.