Tecton TV — TizenBrew Module

Watch movies and TV shows on your Samsung Smart TV using TizenBrew.

Setup

1. Install TizenBrew on your Samsung TV

Follow the TizenBrew installation guide to set up TizenBrew on your Samsung Smart TV.

2. Deploy your Tecton instance

You need a running Tecton instance accessible from your TV. Deploy it to Vercel, Cloudflare, or run it on your local network.

3. Configure the module URL

Edit tizenbrew/app/index.html and replace __TECTON_URL__ with your deployed URL:

var TECTON_URL = 'https://your-tecton-instance.vercel.app';

Or, if you leave the placeholder, the TV will prompt you to enter the URL on first launch (it's saved in localStorage).

4. Publish the module

The TizenBrew module files need to be hosted somewhere accessible. You can:

Option A: GitHub (recommended)

1. Push this tizenbrew/ directory to a GitHub repo
2. Users add the module via TizenBrew's Module Manager using the npm package name

Option B: npm

cd tizenbrew
npm publish

Option C: Local development Run a local server in the tizenbrew/ directory:

cd tizenbrew
npx serve .

Then point TizenBrew to your local server URL.

Remote Key Mapping

| Samsung Remote Key | Action | |---|---| | D-pad (↑↓←→) | Navigate / Seek ±5s (in player) | | Enter/OK | Select / Play/Pause | | Back | Go back / Close overlay | | 🔴 Red | Toggle captions | | 🟢 Green | Toggle fullscreen | | 🟡 Yellow | Toggle mute | | 🔵 Blue | Toggle native subtitles | | ▲ Channel Up | Next episode | | ▼ Channel Down | Previous episode | | ⏸ Media Play/Pause | Play/Pause | | ⏪ Media Rewind | Seek backward 1s | | ⏩ Media Fast Forward | Seek forward 1s | | ⏭ Media Track Next | Next episode | | ⏮ Media Track Previous | Previous episode | | 0–9 Number keys | Jump to 0%–90% of video | | Vol Up/Down | Volume up/down | | Mute | Toggle mute | | Search | Search (opens search overlay) | | Info | Show info |

Architecture

tizenbrew/
├── package.json          # TizenBrew module metadata & key registration
├── service.js            # NodeJS service (Tizen TVInputDevice API)
├── app/
│   └── index.html        # TV-optimized entry point
└── README.md

• package.json: Declares the module type (app), remote keys to register, and entry point
• service.js: Registers all Samsung TV remote keys via tizen.tvinputdevice.registerKey() so the app receives keydown events
• app/index.html: Loads the deployed Tecton instance in an iframe with:
  • Spatial navigation for D-pad focus management
  • TV-optimized CSS (larger text, focus indicators, hidden cursors)
  • Remote key → keyboard shortcut forwarding
  • Loading/error screens
  • Key HUD overlay showing available controls

Customization

Change the Tecton URL at runtime

The URL is saved in the TV's localStorage. To change it, clear storage or the TV will prompt again on next launch if the URL fails.

Add custom key mappings

Edit the keyMap object in tizenbrew/app/index.html to remap keys. The values correspond to keyboard shortcuts defined in src/utils/keyboardShortcuts.ts.

Troubleshooting

• Blank screen: Make sure your Tecton instance is accessible from the TV's network
• Keys not working: Ensure TizenBrew registered the keys (check console for [TectonTV] Registered key: logs)
• CORS errors: Your Tecton deployment needs to allow being loaded in an iframe (X-Frame-Options should not be DENY)
• Loading timeout: Default timeout is 30 seconds. Increase LOAD_TIMEOUT in index.html for slow connections