Welcome to RedSquid

Welcome to the RedSquid platform. This guide will help you deploy your branded TV application on RedSquid-powered devices, providing your customers with a seamless viewing experience while leveraging robust system-level capabilities.

What is RedSquid?

RedSquid is a TV platform that enables operators to deliver their branded applications on television devices while RedSquid provides essential system-level functionality transparently in the background.

The RedSquid Approach

Why Choose RedSquid?

Benefits for Operators

1. Accelerated Time-to-Market

• No System Development Required: RedSquid handles all system-level functionality
• Focus on Content: Invest resources in your content experience, not infrastructure
• Rapid Deployment: From concept to market in weeks, not years
• Standard Web Technologies: Build with HTML5, JavaScript, CSS - no proprietary frameworks

2. Cost Efficiency

• Shared Platform Costs: Leverage shared platform development and maintenance
• No Hardware Development: Use OEM devices with RedSquid pre-installed
• Reduced Support Costs: RedSquid handles system-level issues and updates
• Scalable Infrastructure: Backend services scale with your subscriber base

3. Brand Control

• Your Branding: Complete control over visual identity and user experience
• Themed System UI: RedSquid UI elements adopt your color palette
• Branded Boot Screen: Optional operator logo during boot
• Customizable App: Full control over navigation, layout, and features

Platform Overview

Architecture from Your Perspective

┌─────────────────────────────────────────────────────┐
│              Your Branded Application                │
│  ┌─────────────────────────────────────────────┐   │
│  │   • Home Screen    • EPG / Channel Guide     │   │
│  │   • Content Browse • Search & Discovery      │   │
│  │   • Playback UI    • Settings (app-level)    │   │
│  │   • DVB-I Support  • Recommendations         │   │
│  └─────────────────────────────────────────────┘   │
│                                                     │
│  Your app receives:                                 │
│    ✓ Navigation keys (Home, Back, OK, Arrows)      │
│    ✓ Channel +/- (when your app has focus)         │
│    ✓ EPG key (if available on remote)              │
│    ✓ Number keys (when your app has focus)         │
└─────────────────────────────────────────────────────┘
                         ▲
                         │
                         │ Focus & Key Events
                         │
┌─────────────────────────────────────────────────────┐
│              RedSquid System Layer                   │
│  (Invisible to users except when invoked)           │
│                                                     │
│  Handles automatically:                             │
│    • Volume +/- (overlay)                           │
│    • Mute (overlay)                                 │
│    • Input selection (HDMI, Live TV)                │
│    • Settings (system-level)                        │
│    • Live TV (DTVKit · DVB-I · ATSC 3.0)            │
│    • Power management                               │
└─────────────────────────────────────────────────────┘

User Journey Example

Operator Application Integration

Application Requirements

Application Hosting Options

Option 1: Cloud-Hosted Application Recommended

{
  "operator_id": "youroperator",
  "app_url": "https://tv.youroperator.com/app/",
  "manifest_url": "https://tv.youroperator.com/manifest.json"
}

RedSquid JavaScript API

RedSquid provides a JavaScript API for integration with system functions.

Live TV Integration

// Request Live TV mode
RedSquid.LiveTV.requestFocus()
  .then(() => {
    console.log('Live TV mode activated');
    // RedSquid now handles channel controls
  })
  .catch(err => {
    console.error('Live TV not available:', err);
  });

// Listen for Live TV events
RedSquid.LiveTV.addEventListener('channelChanged', (event) => {
  console.log('Channel changed to:', event.channelNumber);
  updateEPGDisplay(event.channelNumber);
});

// Exit Live TV mode
RedSquid.LiveTV.releaseFocus()
  .then(() => {
    console.log('Returned to app control');
    // App now receives CH+/- keys again
  });

System Information

// Get device info
const deviceInfo = await RedSquid.System.getDeviceInfo();
console.log('Device:', deviceInfo);
// {
//   model: "TV-50-4K-001",
//   firmware: "1.2.0",
//   hdcp: "2.2",
//   drm: ["widevine_l1"],
//   tuners: ["dvb-t", "dvb-s", "dvb-i", "atsc3"]
// }

// Get network status
const network = await RedSquid.Network.getStatus();
console.log('Network:', network);
// {
//   connected: true,
//   type: "wifi",
//   ssid: "HomeNetwork",
//   signal_strength: -45
// }

Branding & Theming

Theme Configuration

RedSquid system UI elements (volume overlay, input selection, settings) can be themed to match your brand.

{
  "operator_id": "youroperator",
  "theme": {
    "colors": {
      "primary": "#00a0d6",
      "background": "#1a1a1a",
      "surface": "#2a2a2a",
      "text": "#ffffff",
      "text_secondary": "#b0b0b0",
      "accent": "#ff5722",
      "success": "#4caf50",
      "warning": "#ff9800",
      "error": "#f44336"
    },
    "typography": {
      "font_family": "Roboto, sans-serif",
      "font_size_base": 16,
      "font_weight_normal": 400,
      "font_weight_bold": 700
    }
  }
}

Brand Assets

Device Configuration

First-Time Installation (FTI)

When a customer first turns on a RedSquid device, the First-Time Installation flow configures the device.

Content & DRM Integration

Supported Video Formats

DRM Support

Widevine Configuration Example

player.configure({
  drm: {
    servers: {
      'com.widevine.alpha': 'https://drm.youroperator.com/widevine/license'
    },
    advanced: {
      'com.widevine.alpha': {
        'videoRobustness': 'HW_SECURE_ALL',
        'audioRobustness': 'HW_SECURE_ALL'
      }
    }
  }
});

Testing & Validation

Testing Phases

Phase 1: Development Testing

Environment: RedSquid Emulator (provided)

• App loads and displays correctly
• Navigation works with keyboard (simulates remote)
• Content playback functions
• DRM content plays (test license server)
• Theme applies correctly
• API integrations work

Phase 2: Device Testing

Environment: RedSquid reference device

• App launches after FTI
• Performance meets targets (< 3s launch, 60fps UI)
• Actual remote control works
• Focus transitions smooth (app ↔ RedSquid overlays)
• Memory usage acceptable (< 300MB)
• No crashes or freezes during extended use

Phase 3: Operator Acceptance Testing (OAT)

Environment: Production-like setup with your backend services

• End-to-end user workflows
• Content catalog browsing
• Search functionality
• Recommendations engine
• Playback of various content types
• DRM content playback (live license server)
• Network resilience (handle connection drops)

Performance Benchmarks

• App launch: < 3 seconds
• Screen transitions: < 300ms
• Playback startup: < 2 seconds
• Search results: < 1 second
• UI frame rate: 60fps maintained

Deployment & Distribution

Deployment Models

Application Updates

Cloud-Hosted Apps (Instant Updates)

Ongoing Operations

Analytics & Telemetry

Built-In Analytics

RedSquid automatically collects:

• App launch events
• Crash reports
• Performance metrics (launch time, memory usage)
• System events (boot, network changes, updates)

Access via: Operator Portal → Analytics Dashboard

Custom Analytics

// Track custom events
RedSquid.Analytics.trackEvent({
  category: 'Content',
  action: 'Play',
  label: 'Movie: The Great Film',
  value: 120, // duration in minutes
  customData: {
    content_id: 'movie-12345',
    genre: 'Drama',
    quality: '4K'
  }
});

Monitoring & Alerts

Operator Portal Dashboard shows:

• Active devices
• App crash rate
• Playback success rate
• Network connectivity rate
• Average playback quality
• Support ticket volume

Support & Resources

Documentation Portal

Developer Support

Contact:

• Email: operator-support@redsquid.tv
• Forum: https://forum.redsquid.tv/operators
• Slack: Request invite via operator portal

Getting Started Checklist

Contact Information

RedSquid Technologies Ltd.

• Website: https://www.redsquid.tv
• Email: info@redsquid.tv
• Operator Partnerships: operators@redsquid.tv
• Technical Support: operator-support@redsquid.tv
• Portal: https://portal.redsquid.tv