Browser Emulator Help Guide
This document explains how to install Browser Emulator and how to use it (Version 5.0)
Introduction
Samsung SmartTV Browser Emulator is a system that provides Browser Emulator function for normal user and server management function for administrator.
The Browser Emulator provides the following functions to administrator:
- Account management to both admin user and normal users
- Network setting: IP setting, proxy setting
- Server management: power off, reboot
- System performance: memory, CPU usage
The Browser Emulator provides the following functions to normal user:
- Smart Apps Management (download, upload, share/unshared, installation)
- SEditor: Simply editor for Smart App codes
- Account Management: Sign in, Sign up, retrieve password by security question
- Key Mapping: Map remote controller key with keys on keyboard
- Log panel & Inspector
Purpose
This document is designed to introduce how to deploy and Use Samsung SmartTV Browser Emulator. This document covers the detail introductions of functions and user interface (UI) of the Browser Emulator.
Scope
This paper is easy to understand even if you don’t have experience of programming.
Administrator is suggested to read Introduction and Guide for Administrator.
Normal User is suggested to read Introduction and Guide for Normal Users.
System Requirement
Hardware Requirements
Component | Item | Detail |
---|---|---|
Browser Emulator | Processor | CPU @3.30GHz x 2 or higher |
RAM | 4GB or higher | |
Screen resolution | 1440 x 960 or higher | |
Video memory | 256MB or higher |
Software Requirements
Component | Item | Detail |
---|---|---|
Browser Emulator | VirtualBox 4.24 or higher | https://www.virtualbox.org/wiki/Downloads |
Chrome version v.30 or higher | https://www.google.com/intl/en/chrome/browser/ |
Prerequisites
- Network connection type of Virtual Box must be Bridged
- Only Administrator can sign in from VirtualBox.
- Default Administrator Account: username:”admin”, password:”123456”.
- Network Access Address: http://YourNetworkIPSetbyAdminstor/WebServer/
Guide for Administrator
Install Browser Emulator
Before install Browser Emulator, VirtualBox must be installed first. To access Admin Tools Module in Browser Emulator, Chrome should be installed.
Download latest ova from http://www.samsungdforum.com/, double click the ova file and load the ova to VirtualBox as guide. Allocate more CPUs or set bigger memories to get better performance.

VirtualBox Network Settings
After setup, you must make sure the network connection type of VirtualBox is Bridged.
You can set the network connection type of VirtualBox as followed steps:
Exit the Browser Emulator program. Open the VirtualBox.

Right click on the left item “Browser Emulator”, and click the item “Settings”.

Click on the left item “Network”, and you will “see connection type” on the right, then choose the type of “Bridged”.

Normally, after VirtualBox network setting is over, change other parameters if necessary (such as MAC address). Then, start Browser Emulator in VirtualBox. After a few seconds the Browser Emulator starts successfully and shows the interfaces.

Sign in use default username:”admin”, password:”123456”. Then login to the User Management page, click the NAV to “Network”->”IP Setting” on the page and jump to IP Setting page. Input your configuration of network and click “Confirm” Button” and finish network setting.

Getting Started with Browser Emulator for Administrator
Please use chrome to visit the Admin Tools module. The available address will be “http://NetworkIP/WebServer/”.

Note
Please use the network IP which you have set. If you don’t remember, please login to Admin Tools module inside VirtualBox and see your current IP at “Network”->”IP Setting” page.
Administrator Account Management
Sign in Browser Emulator
Run the Browser Emulator program, the login page will show as followings.

Fill the form with default user name (admin) and password (123456), choose “Remember me for one week” if you want to login Browser Emulator without inputting username and password again in one week. Click the Sign in button, and then you will get the Browser Emulator default page.

Change administrator’s password
Move over “Welcome Admin”, choose the drop menu item “Change Password”.

Click “Change Password”, then a popup will appear. Fill the form with your old password, new password and confirm password, make sure the password has 6-20 characters and only contains letters and numbers. Click the “OK” button to submit.

If change password successful, the notice message will appear as follow.

Logout Browser Emulator
Move over “Welcome Admin” and choose the drop menu item “Log Out”.

After click, you will logout to the login page. When your account login on another site, you are forced to logout.

User Account Management
User list
After login or choose “User Management” of the menu, the User Management page will show. First it has no user in User List. In the user list, admin can delete Browser Emulator users. Online users cannot be deleted.
Delete user
Click delete user icon, then a popup will appear to reconfirm you.

System Information
Click the “System Information” tab of the menu. You can get CPU usage, memory usage and online user member of the server as follow.

Network setting
IP setting
Move over “Network” tab and click the drop menu item “IP setting”.

After loading this page, you can see the current IP information of the server.

If you want to set new IP information, you can fill them in the form and click confirm bottom if you want to change.

After setting, you should re login Browser Emulator by new IP address.
Network proxy
Move over “Network” and click the drop menu item “Network Proxy”.

After loading this page, you can see the current network Proxy of the server. If the current proxy method is none, the page will show as follow.

You can set network Proxy by three methods: none, manual, automatic. Choose the method you want and click confirm button to store.

Method: None

Method: Manual

Method: Automatic
Note
Once you have set up the proxy, you may not use the default browser inside Browser Emulator to access Admin Tools Module. Error like “Unable to load page” will happen.
If you want to use the browser inside VirtualBox to access Admin Tools, please set the proxy the “NONE” mode or use the proper proxy and restart Browser Emulator.

System Management
Power off
Move over “Turn Off” and click the drop menu item “Power Off” to exit Browser Emulator.

It will reconfirm you again, make sure you want to turn off.
Reboot
Move over “Turn Off”, click the drop menu item “Reboot” to reboot Browser Emulator.

It will reconfirm you again, make sure you want to reboot.
Guide for Normal Users
Getting Started with Browser Emulator
Only after administrator has installed Browser Emulator and finished setting up environment, users can access it with “http://NetworkIP/WebServer/”.
For example, if the Browser Emulator IP address is: “10.0.2.2”, then the address will be “http://10.0.2.2/WebServer”.
Access to main page
Input the address you can access to main page as following page:

Create your account
New User need sign up a new account. The username must contains no more than 20 numbers (0~9) or symbols (A~Za~z). The password must contains 6~20 numbers (0~9) or symbols (A~Za~z).
If password is forgotten, answer the verification question can reset the password.
Smart Apps Management
Smart App Manager will replace the Smart Hub in Browser Emulator, which have three categories:
- My Apps
- Apps which users can debug with Emulator, edit with S Editor. Users can upload local Apps with zip format; can install Apps from Shared Apps or Sample Apps.
- Shared Apps
- Apps which are shared by team members, this help to enhance the team work.
- Sample Apps
- Apps which are released at SDF (Samsung Developer Forum http://www.samsungdforum.com/)
Upload local apps
Sign the Browser Emulator to access the Smart App Manager page. Click upload button at “My Apps” and a file selector will be popped and choose a valid App with zip format.

Note
Use “Back” function on browser will immediately cancel uploading.
Download apps
When the mouse focuses on one App at any categories, users can click the download button to download the App.

Install / Update app
When the mouse focuses on one App at “Shared Apps” or “Sample Apps”, user can click the install button to install the selected App to “My Apps”, and then user can run the App, also can read/modify the codes.
Once you have installed the App, the button will become updated, you can click it to update the App.

Note
When you update the installed App, the App in “My Apps” and all the code which you modified will be overwritten.
S Editor
S Editor provides online editor function for the Apps at “My Apps” as following figure.

Note
If you access from Smart App Manager, you can edit the codes of any Apps at “My Apps”.
If you access after launching one Apps, the running Apps will be listed at the top view.
You can only open 10 editor pages at one time
Online debug
User can ONLY debug the Apps at “My Apps”. When user clicks one App at “My Apps”, the App will be launched.
Browser Emulator provide S Editor, Instance Log and Web Inspector, three type Remote Controls and Key Mapping functions to help user debug his Apps with rapid and high efficient way.

Instance Log & Web Inspector
When user launched one App, the instance log of App output will be showed at log panel.

Web inspector can help to debug Apps. Click the “Inspector” tab to switch to inspector. Then click the target page which needs to be inspected.

Click “Elements” tab to inspect html elements. Edit the elements or css to see the changes.

Key mapping
Key Mapping enables user to map the remote control key to the key on keyboard which is a very efficient way to emulate App.
Combination keys are not supported. The valid key scope on the keyboard which can be mapped is showed as the following picture.

To set a mapping key:
- Click the “Setting” button when begins emulation.
- Setting panel will be popped and five default key can been seen at the right side mapping list.
- If you want to set other keys on the remote control, just double click the key on the remote control. Then the related key will be added into the setting list.
- Choose a key in the setting list and type a key on the keyboard. Click “OK” button will save your mappings.
