@signageos/cli v1.4.1

CLI program

signageOS command-line interface which helps you develop your applets locally and manage devices from terminal.

Usage

npm install @signageos/cli -g
sos --help

User Interface

cli tool allows you to run commands interactively for best user experience, please use standard bash terminal on *nix systems and gitbash, run it in windows terminal.

Test

cp .env.amy .env
# Unit tests
npm test
# Integration tests (against AMY environment)
npm run test-integration

API reference

General

Login

Requirements

• Active account. It can be obtained by manual sign-up in https://box.signageos.io

sos login

• Login account to allow use REST API commands
• Logged account credentials are stored in ~/.sosrc file.
• You override login credentials using environment variables SOS_API_IDENTIFICATION & SOS_API_SECURITY_TOKEN. Go to https://box.signageos.io/settings to generate the token.

Run control file

There are file created when run command sos login in the path ~/.sosrc. This file contains by default only following values (as default profile is used).

identification=xxxxxxxxxxxxxxxxxxxx
apiSecurityToken=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

If you'd like to manage more accounts/configurations on one machine, you can use environment variable SOS_PROFILE or argument --profile. The configuration file will uses a INI section profile xxxx for the profile named xxxx. You can use as many profiles as you want.

[profile xxxx]
identification=xxxxxxxxxxxxxxxxxxxx
apiSecurityToken=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Applet

sos applet --help

Applet Generation

sos applet generate --name my-sample-applet --language=typescript
cd my-sample-applet
# Develop your applet with watching changes
npm start
# Build your applet production environment
npm run build

! Windows users note: There are unresolved issue with NPX tool on Windows clients when your username contains spaces (e.g.: John Doe). https://stackoverflow.com/a/58354623/4609457 To prevent this issue there is simple hotfix. Run following command in your Command Line (replace John with your real first name): Sometimes the Administrator privileges are required (Run as Administrator)

npm config set cache "C:\Users\John~1\AppData\Roaming\npm-cache" --global

Applet Upload

npm run upload
# Uploads all files in the applet directory
# Or alternatively you can use direct cli: `sos applet upload`

#Deprecated
sos applet upload --applet-path=dist/index.html
# This will upload only the one specified file
# Rest of the files will be removed from our servers

• If applet is not created yet, it will create it
• The applet version is used from package.json
• Applet UID will be stored in package.json sos.appletUid
• You can use SOS_APPLET_UID as environment variable to specify appletUid to upload to (sos.appletUid of package.json will be overlooked).
• You can use SOS_APPLET_VERSION as environment variable to specify applet version to upload to (version of package.json will be overlooked).
• Ignore files priority (from top to bottom) .sosignore > .npmignore > .gitignore
• Only one ignore file is used or non

Applet Build

sos applet build
# Build applet locally. The result is a zip file in the /tmp/signageos directory.

Applet Start

sos applet start

• It's meant to be used with applets not created using the cli
• Default values work for applet created using the cli

Applet Tests Upload

sos applet test upload

• Upload all test files specified in package.json in sos.tests. The property is array of strings (relative paths to test files). E.g.: ["tests/sample.spec.js", "tests/sample2.spec.js"]
• It removes files which are extra on server already

Applet Tests Run

sos applet test run

• Run test files uploaded to server remotely.

Organization

sos organization --help

Organization List

• Output is printed to STDOUT as JSON

sos organization list

Organization Get

• Output is printed to STDOUT as JSON

sos organization get

Organization Set Default

• Sets default organization for current logged in account. This organization will be used for example in webpack plugin of applet to register emulator
• If you not set default organization, by default will be used the organization you will be asked to select from list where you have access to.

sos organization set-default

• You override default organization using environment variable SOS_ORGANIZATION_UID. Go to https://box.signageos.io/organizations to git the organizationUid.

Timing

sos timing --help

Timing List

• Output is printed to STDOUT as JSON

sos timing list

Device

sos device --help

Device Power action

Perform specified power action on a device.

sos device power-action

Device Power action types

Device Set-Content

sos device set-content

Device connect

sos device connect
# You will be provided with setting parameters
# You should build and upload applet to box before connecting applet to device 
# The applet has to be at least uploaded once with the specific version

Contribution

Clone the repository and install dev dependencies

git clone git@github.com:signageos/cli.git # or https://github.com/signageos/cli.git
npm install

To try sos command directly from source code, use ts-node src/index.ts instead of sos in project directory.

Global requirements

npm install ts-node -g