Running webOS project

Running webOS project


The webOS TV CLI (Command Line Interface) provides a collection of commands used for creating, packaging, installing, and launching web apps in the command line environment. The CLI allows you to develop and test your app without using a specific IDE.

Install @webosose/ares-cli

You can run installation via npm by installing npm package of @weboose/ares-cli by running

$ npm i @webosose/ares-cli
  • verify installation by running
$ ares -V
Version: 2.3.1

Note: Node version 10.24.1 to 14.15.1 are recommended.

If that is not working, you can follow official guide for installing ares-cli.


With the webOS TV CLI, you can install your apps on a target device, such as the simulator, emulator, or webOS TV device. Besides, you can retrieve, run, terminate, and remove the apps installed on the target device. You can use the CLI during any of the following stages of the development process:

Development process


Be aware that before using any of commands you need to have ares-cli installed first. Most important commands that you will need you can find in table below:

Set up WebOS project

  • Start by generating project
ares //check help
ares-generate  ./ares-test-app //generate project in folder ares-test-app
  • create device
> ares-setup-device
name                deviceinfo                connection  profile
------------------  ------------------------  ----------  -------
emulator (default)  developer@  ssh         ose

** You can modify the device info in the above list, or add new device.
? Select add
? Enter Device Name: webos_simulator
? Enter Device IP address:
? Enter Device Port: 22
? Enter ssh user: root
? Enter description: new device
? Select authentication password
? Enter password: [hidden]
? Set default ? Yes
? Save ? Yes
name                       deviceinfo                connection  profile
-------------------------  ------------------------  ----------  -------
webos_simulator (default)  root@         ssh         ose
emulator                   developer@  ssh         ose
  • Checkout created device:
> ares-setup-device --list
name                       deviceinfo                connection  profile
-------------------------  ------------------------  ----------  -------
webos_simulator (default)  root@         ssh         ose
emulator                   developer@  ssh         ose

Configuring @webosose/ares-cli

This is partially based on:

1.) Install Developer Mode app from Content Store

2.) Enable developer mode, enable keyserver

3.) Download TV's private key: TV_IP:9991/webos_rsa and save under $HOME/.ssh

4.) As with any SSH key, restrict its access rights: chmod 600 ~/.ssh/webos_rsa

5.) You can test the key with: ssh-keygen -y -P "PASSPHRASE" -f ~/.ssh/webos_rsa

6.) Configure the device using ares-setup-device (-a may need to be replaced with -m if device named webos is already configured) PASSPHRASE is the 6-character passphrase printed on screen in developer mode app

ares-setup-device -a webos -i "username=prisoner" -i "privatekey=webos_rsa" -i "passphrase=PASSPHRASE"
 -i "host=TV_IP" -i "port=9922"

Running and installing application on LG TV

When we have our code ready for deploying it to TV, we must first package our project to .ipk file, install that .ipk to TV device and finally we can launch it or inspect it. For this last part you dont need to launch it from terminal you can launch application manually by using TV remote as well, but of course if you want to inspect it and debug application you will need to run command from terminal. Lets go step by step:

  • run ares-package in order to package project

    ares-package ./
  • After ares-package command is finished and we have .ipk file output, we can proceed to install application on TV

    ares-install -d webos com.testwebos.app_1.0.0_all.ipk
  • Launch application on TV, -d parameter represent on which device you want to run (in my case device is named webos)

    ares-launch -d webos
  • inspect and debug WebOS application

    ares-inspect -d webos -a -v
  • After you are done you can close application by running :

    ares-launch -d webos -c


Here it is, you should have your application started on your TV, so now you can bring your idea to life. Setup of webOS project is straight forward as you can see, if you stuck on some step, and you cannot find solution feel free to contact me and I will be glad to help if I can. When you finish developing your application next step is to go to the LG seller lounge and register your app after everything is done your app should appear at LG store. I hope I will make post about that as well in the near future, so we can close the whole LG webOS development process circle.

You can checkout original post
and find more information about webos