Have more questions? Submit a request

Connect Applet to device with signageOS CLI

Fast track your development with instant deployment of your Applet directly from CLI to selected device in your local network.


Tech stack

You need the following stack to get started with your development:

TIP: Windows Terminal and Cmder allows open more than one console window which can be helpful in the daily development work.

1. signageOS CLI

  • Install signageOS CLI npm install @signageos/cli@latest -g
  • Login with CLI sos login
  • Set default Organization sos organization set-default

2. Code your project

Build from scratch

  Start Your development with CLI

Continue here

  Use your existing application with CLI

Continue here

3. Build Applet

  • navigate to your Applet's folder and run command npm run build to finish the Applet building process.

  • Alternatively, when you use your own coded Applet you perform your specific command to build your project.

4. Upload Applet to Box

  • To use sos device connect you have to add Applet information (appletUid, appletVersion) to package.json. The correct way is to run the upload command:
sos applet upload
  • Command will upload your Applet to signageOs Box and will allow sending the Applet to the device directly from CLI

5. Install the latest Core App on your device

To use this feature, you need at least the following versions of Core App on your displays:

Platform Min. Core App version
Samsung Tizen 2.2.0 (or latest RC version)
LG webOS 2.2.0 (or latest RC version)
BrightSign 1.4.0 (or latest RC version)
Android 3.6.0 (or latest RC version)
Raspberry Pi 1.4.0 (or latest RC version)


TIP: How to update Core App in Box or REST API


Using sos device connect

  • If you performed all steps described above you are ready to send your Applet to selected device within your local network.

  • You should be in root folder of your Applet project when running the command to connect to a device:

    sos device connect
    • You can pass these arguments after command, or the command will provide you with interactive selection
Argument Description Default value
--ip (required) Ip address of computer in local network Automatically get from networkInterface
--device-uid (required) Uid of device from Box STDIN
--applet-dir (required) Directory of the Applet project ${PWD}
  • It may take several seconds before the Applet is displayed on your device

  • To exit the development mode press CTRL + C or CMD + C while you are in your terminal. This command will stop the connection and the content on the display should return to previous state.

Applet auto-reload 

  • This feature is available only when you use our webpack plugin in your project. Plugin is automatically installed in applets generated via CLI's command sos applet generate

  • In one terminal you perform sos device connect and in another window you run npm run connect (you have to be in the Applet directory in both terminals) 

  • Alternatively, if you want to display changes you need to stop sos device connect -> build your Applet -> perform sos device connect

Was this article helpful?
0 out of 0 found this helpful