Tizen Enplug Player

A Samsung Tizen TV wrapper application for the Enplug digital signage player. This project provides Tizen-specific service implementations that integrate with the @enplug/core-player npm package.

Prerequisites

• Node.js 20
• Tizen Studio with CLI tools
• Samsung TV/Signage device connected to network

Quick Start

# Install dependencies
npm install

# Connect to device (default IP: 192.168.50.200)
npm run connect-device

# Build, deploy and debug
npm run debug-dev

Development Commands

Essential Commands

# Development workflow (most common)
npm run debug-dev                    # Clean + build + deploy + debug with port forwarding

# Production deployment
npm run debug-prod                   # Clean + build production + deploy + debug

# Build only
npm run build-dev                    # Development build
npm run build                        # Production build

# Clean build artifacts
npm run clean                        # Always run this first when having build issues

Device Connection (CLI - No Device Manager needed)

# Connect to default device (192.168.50.200)
npm run connect-device

# Connect to specific IP
npm run connect-device --ip=192.168.1.100

# List connected devices
npm run list-devices

# Disconnect all devices
npm run disconnect-device

# Manual connection
sdb connect 192.168.50.200:26101
sdb devices

Debug Commands

# Debug with automatic port forwarding to localhost:9222
npm run debug-with-port

# Basic debug (no port forwarding)
npm run debug

# Run in Tizen simulator
npm run simulator

Deployment Commands

# Deploy production without debug (creates release/x-x-x/ with .wgt and sssp_config.xml)
npm run deploy

# Deploy development without debug (creates release-dev/x-x-x/ with .wgt and sssp_config.xml)
npm run deploy-dev

# Individual steps
npm run build-web                    # Build Tizen web package
npm run package                      # Create .wgt file
npm run tzinstall                    # Install on device

Release Signing and Distribution

⚠️ Important: The .wgt files generated in release/ and release-dev/ directories are signed with development certificates and are only valid for emulator testing.

For production deployment to Samsung TVs, follow these steps:

1. Generate release files: Run npm run deploy or npm run deploy-dev

2. Re-sign for production:

   • Go to Samsung B2B Package Tool
   • Upload the generated .wgt file from your release directory
   • Download the production-signed package

3. Replace in release directory:

   • Replace the original .wgt file in release/x-x-x/ or release-dev/x-x-x/ with the production-signed version
   • Keep the same filename and directory structure

4. Version and distribute:

   • Commit the signed release to GitHub
   • Tag the release with the version number
   • Upload to distribution platforms

Utility Commands

# Watch mode (rebuild on changes)
npm run build-w

# Full development build and simulator
npm run start

Recommended Workflows

Active Development

# 1. Connect device
npm run connect-device

# 2. Build, deploy and debug
npm run debug-dev

# 3. After code changes
npm run clean && npm run debug-dev

Production Testing

# Build and test production version
npm run debug-prod

# Deploy production without debug
npm run deploy

Chrome DevTools Access

After running debug commands:

• Chrome DevTools: chrome://inspect
• Direct access: localhost:9222
• Device access: http://192.168.50.200:<port> (port shown in console)

Troubleshooting

Build Issues

# Clean and rebuild
npm run clean
npm run debug-dev

# Check Tizen tools
tizen version
sdb devices

Connection Issues

# Check device connection
sdb devices
sdb get-state

# Reconnect device
npm run disconnect-device
npm run connect-device --ip=<DEVICE_IP>

Debug Issues

# Check port forwarding
sdb forward --list

# Clean and restart debug
sdb forward --remove-all
npm run debug-with-port

Installation

Development Tools Setup

1. Install VS Code

   • https://code.visualstudio.com/download

2. Install Tizen Studio

   • https://docs.tizen.org/application/tizen-studio/setup/install-sdk

3. Install Tizen Web CLI

   • https://webostv.developer.lge.com/develop/tools/webos-studio-installation

4. Create Certificates

   • https://docs.tizen.org/application/dotnet/get-started/certificates/installing-the-extension
   • https://docs.tizen.org/application/dotnet/get-started/certificates/creating-certificates

5. Install Dependencies

   npm install

Project Structure

• src/ - Tizen-specific service implementations
• core-player-web/ - Core player (from npm link)
• .buildResult/ - Build output directory
• scripts/ - Custom build and debug scripts
• release/ - Production releases (ignored by git)
• release-dev/ - Development releases (ignored by git)

Target Device

• Default device: SBB-SS08NT2
• Default IP: 192.168.50.200
• Target platform: Samsung Tizen TV/Signage

URLs

• Production: https://downloads.spectrio.com/tizen

Configuration

The project is configured for 2-space indentation with:

• Prettier
• ESLint
• EditorConfig
• VS Code settings