Skip to main content

Quickstart

Get a working sideload onto your Roku device in minutes

Architecture

Understand how the app is structured and how screens communicate

Build & Deploy

Package, sideload, sign, and submit to the Channel Store

Certification

Everything you need to pass the Roku 2026 certification checklist

​
What is GlobalTV Roku?

GlobalTV Roku is a native Roku SceneGraph channel application that delivers live TV streaming to Roku devices. It is built in BrightScript and implements the full viewer journey — from first launch through channel playback — along with a rich feature set required for commercial deployment.

Live Playback

HLS/M3U8 stream playback with overlay, error handling, and automatic reconnection

On-Device Auth

Credential-based login with auto-login and Roku Registry persistence

Ad System

Three ad formats (A, B, C) with polling, impression tracking, and viewport management

Deep Linking

Supports mediaType=live deep links for both launch and input events

Connectivity

Periodic background connectivity polling with graceful offline handling

Channel Store Ready

Built-in make check target validates all Roku 2026 certification requirements

​
Application version

The current release is v1.0.6 (manifest build_version=7). The internal constant APP_VERSION in source/AppConstants.brs must stay in sync with the manifest.

​
Technology stack

LayerTechnology
LanguageBrightScript
UI frameworkRoku SceneGraph (RSG)
StreamingHLS / M3U8
Build toolingGNU Make, zip, curl
Target platformRoku OS (RSG 1.3, FHD + HD)

​
Repository layout

manifest                  ← Channel metadata and certification fields
Makefile                  ← Build, sideload, package, and check targets
source/
  main.brs                ← Entry point; creates scene and handles deep links
  AppConstants.brs        ← All configuration constants (endpoints, timeouts, colors)
  AppState.brs            ← Global state initialization (m.global fields)
  utils/                  ← Shared utilities (HTTP, logging, registry, parsing)
components/
  MainScene.*             ← Root scene; orchestrates the full app lifecycle
  SplashScreen/           ← Launch splash with logo
  OnboardingScreen/       ← First-run onboarding flow
  LoginScreen/            ← On-device credential login
  MainScreen/             ← Channel grid / list with AppLaunchComplete beacon
  PlayerScreen/           ← Live stream player with overlays and ads
  SettingsScreen/         ← Server management, channel refresh, logout
  tasks/                  ← Background tasks (auth, playlist, ads, connectivity, metrics)
  ads/                    ← Ad manager and three format renderers
  overlays/               ← Channel number and info overlays
images/                   ← Channel icons, splash screens, HD/FHD logos
out/                      ← Build output (zip, pkg, screenshots)

​
Next steps

Requirements

Hardware and software prerequisites before you start

App flow

Trace the full execution path from launch to playback