Installing an App in demo mode on an LG TV

These notes are from LG's own support material. The latest should be checked here http://webostv.developer.lge.com/develop/app-test#installDevModeApp

App Testing

After you complete developing the app, you might need to test your app. The Developer Mode app provides a faster way to install, debug, and test webOS TV apps on the TV. The following introduces the concept behind the Developer Mode app that connects between the TV and the PC.

To use the Developer Mode app, the following should be ready in advance:

• LG WebOS TV connected with a network
• PC connected with a network and installed with the webOS TV SDK Follow the instructions in that link to install the SDK.
• LG Developer site account
  The Developer Mode app requires you to sign in to the LG Developer site. If you do not have an account yet, see Preparing a Login Account.

This process follows these steps

• Preparing a login account
• Installing Developer mode app
• Turning Developer mode on
• Connecting TV and PC
• Extending Developer mode time
• Clearing cache data of apps

Preparing a Login Account

To use the Developer Mode app, you must be a member of the LG Developer site. If you are not a member of the site, follow the below steps to create an account on the LG Account. If you already have the account for the LG Developer site, skip this section and go on to Installing Developer Mode App. 

1. Go to the Sign In.
2. Select the CREATE ACCOUNT tab. The Select Country pop-up appears. 
3. Select your country from the drop-down menu and click CONFIRM.
4. Read through and accept LG Terms & Conditions and Privacy Policy on the Accept Terms & Conditions screen.
5. Click AGREE to create your new LG Account.
6. Enter your email address as User ID, password, and date of birth.
7. Select whether to subscribe to LG mailing list, then click CONFIRM.
8. LG will send you a verification email to your address. Click CONFIRM in the verification email to complete verification.
9. 
10. Once the Account Created screen appears, go to the Sign In again.
11. Sign in to LG Developer using your new LG Account credentials.
12. From the My Account screen, enter additional information required and click Save.

Installing Developer Mode App

To install the Developer Mode app on the TV, follow the steps below:

1. Turn on your webOS TV and check if your webOS TV is connected to a network.
2. Sign in with your LG Developer site account.
3. Go to the LG Content Store.
4. Search for "Developer Mode."
5. Select the Developer Mode app and click the Install button.

Turning Developer Mode On

After installing the Developer Mode app, you can enable Developer Mode on your TV.

1. Run the Developer Mode app from the webOS TV app launcher.
2. Enter your email-based ID and password of the LG Developer site. See Preparing Account.
   
3. You will get a 2-stage authentication process - an e-mail will be sent to your account from LG asking you to confirm the sign-in.
4. Once confirmed go back to the Developer Mode app and re-sign in. It may ask you to reboot the TV.
5. Click the Dev Mode Status button to enable the Developer Mode. The TV will reboot.
   

Developer Mode is disabled when:

• The TV has been rebooted ten times while the TV is not connected to a network (webOS TV v1.x and v2.0).
• Developer Mode has been enabled for 50 hours.
• The Developer Mode login session is terminated.

If you sign in to multiple TVs with one account, only the session of the latest TV that you sign in to is maintained. 

Important: After Developer Mode is disabled, any sideloaded apps that are installed while you were using Developer Mode will be uninstalled, and you will be taken to the log-in screen of the Developer Mode app.

Connecting TV and PC

This section describes how to connect webOS TV and your PC. You can use either the CLI or IDE for the Developer Mode app.

Connecting with CLI

Follow the instructions below to add the target TV with the CLI tool on your PC:

1. Run the webOS TV CLI.You should already have installed the WebOS SDK http://webostv.developer.lge.com/sdk/installation/

Click this icon on your PC to run the CLI.     

1. Execute the ares-setup-device command. Then, select add.
   

   ares-setup-device
   
   name deviceinfo connection profile
   -------- ------------------------ ---------- -------
   emulator developer@127.0.0.1:6622 ssh tv
   ** You can modify the device info in the above list, or add new device.
   ? Select: (Use arrow keys)
   > add
   modify
   remove

2. Input the information about your TV as below example:
   You do not need to enter the password. When using the Developer Mode app, a password is not required.
   ** You can modify the device info in the above list, or add new device.
   

   ? Select: add
   ? Enter Device Name: tv2
   ? Enter Device IP address: 10.123.45.67
   ? Enter Device Port: 9922
   ? Enter ssh user: prisoner
   ? Enter description: new device
   ? Select authentification: password
   ? Enter password:
   ? Save ? Yes
   name deviceinfo connection profile
   -------- -------------------------- ---------- -------
   tv2 prisoner@10.123.45.67:9922 ssh tv
   emulator developer@127.0.0.1:6622 ssh tv

3. After adding your TV as the target device, check the result with the command below:
   

   ares-setup-device -list

4. Click the Key Server button in the Developer Mode app.
   
5. Get the key file from your webOS TV with the following command on your PC:
   

   ares-novacom --device tv2 --getkey

6. A command prompt appears to enter Passphrase. Enter the exact characters (case sensitive) as displayed on your TV screen.
   You can see Passphrase, which consists of 6 characters on the bottom left side of the Developer Mode app screen.
   

   input passphrase [default: webos]:

7. Check the connection with your TV and PC with the following command:
   

   ares-install --device tv2 --list

8. Now, you are ready to install and launch your app on your real TV. To find out how to install and launch your app on your LG TV, go to these LG instructions Installing and launching your app using CLI. However, a summary is presented below

Connecting with Web OS IDE

Follow the instructions below to add your TV as the target device using the IDE:

Run the webOS TV IDE app on your PC 

Click New Connection () from the Target Configuration screen.

Enter the information about your TV as below example:

• • Set Device Type as LG Smart TV.
  • Change Device Name as you want
  • Input the IP address of your TV - find this from the settings of your actual TV set.

Click the Key Server button in the Developer Mode app on your TV

Right-click the created target device in the web OS IDE tool and select Generate Key. 

The webOS key window appears to enter Passphrase. Enter the exact characters (case sensitive) as displayed on your TV screen.
You can see Passphrase, which consists of 6 characters on the bottom left side of the Developer Mode app screen.

Connect your TV using the right-click menu on the name of the TV. Then you can see the apps you installed on the TV under tv > Installed. If it is your first time using the Developer Mode app, no app is shown on the screen.

Now, you are ready to install and launch your app on your real TV. To find out how to install and launch your app on your TV, go to Installing and launching your app using IDE. A summary of the process is shown here that is a little easier to understand than the LG information.

Installing a Zapp on on your LG TV

1. Download your built Applicaster LG app ipk file from Zapp

2. Open the Web OS CLI tool on your PC 

In the command line enter

ares-install -d [name given to your TV] [path on your PC to your downloaded ipk file]

for example if the TV has been given the name LGTV in the IDE config process above and the downloaded ipk file is in your downloads folder on the pc the complete command will be

ares-install -d LGTV /Users/mymac/Downloads/com.applicaster.il.ch1_1.1.6_all.ipk 

The exact name of the ipk file will also change depending on your app creation choices in Zapp. Note, you can drag and drop the ipk file from your PC into the terminal window.

Press enter and you will get a success message when the app is loaded on your TV. It can be found in the row of apps in the TV app launcher menu.

Extending Developer Mode Time

Developer Mode enables for a limited time. When you turn on Developer Mode, you can check the remaining session time on the Remain Session field. To extend the remaining time, click the EXTEND button. Even the session time has run out, if you do not turn your TV off, you can extend the time with the EXTEND button. 

Clearing Cache Data of Apps

The Developer Mode app provides the Clear Cache Data feature for testing. Note that all apps' cache data is removed. To clear cache data of all apps, follow the instructions below:

Click the ON button on the Clear Cache Data field. 

Reboot the TV.