Skip to main content

sos

SignageOS CLI - Main command entry point

Overview​

The signageOS CLI is a command-line tool for managing applets, devices, organizations, and other signageOS resources. It provides a comprehensive set of commands for the complete development lifecycle from applet creation to deployment.

Key Features​

  • Applet Development: Create, build, test, and deploy applets
  • Development Tools: Connect to devices for testing, upload custom scripts and debug
  • Device Management: Control device power states and applet timings
  • Organization Management: Handle multi-tenant environments
  • Authentication: Secure login and profile management

Installation​

npm install -g @signageos/cli

Getting Started​

  1. Login to your account: sos login
  2. Generate a new applet: sos applet generate --name my-applet
  3. Start development: cd my-applet && sos applet start

Usage​

sos [options] <command>

Debugging​

To enable debugging for specific modules, use the DEBUG environment variable:

# Debug applet upload module
DEBUG=@signageos/cli:Applet:Upload:appletUploadFacade sos applet upload

# Debug all signageOS modules
DEBUG=@signageos/* sos applet upload

# Set debug environment variable
export DEBUG=@signageos/*

Description​

The root command for the signageOS CLI tool that provides comprehensive management capabilities for applets, devices, organizations, and other signageOS resources. This command serves as the entry point for all CLI operations and coordinates access to all available command groups.

Options​

OptionTypeDescriptionDefault
--command, -cstring(default) Command name``
--help, -hbooleanDisplay this usage guide.
--api-url, -ustringAPI URL to be used for REST requests
--version, -vbooleanDisplay installed version of the CLI.
--profilestringsignageOS Profile to be used for authentication and other values from ~/.sosrc config file.

Commands​

Development​

sos applet​

Applet development and management operations

Available commands: sos applet generate, sos applet upload, sos applet start, sos applet test, sos applet build, sos applet delete

→ See detailed documentation

sos custom-script​

Custom Script management

Available commands: sos custom-script upload, sos custom-script generate

→ See detailed documentation

Authentication​

sos login​

Authenticate user with signageOS

→ See detailed documentation

Management​

sos organization​

Organization management operations

Available commands: sos organization list, sos organization get, sos organization set-default

→ See detailed documentation

sos timing​

Timing management

Available commands: sos timing list

→ See detailed documentation

sos device​

Device management

Available commands: sos device set-content, sos device power-action, sos device connect

→ See detailed documentation

Tools​

sos autocomplete​

CLI auto-completion management

Available commands: sos autocomplete install, sos autocomplete uninstall

→ See detailed documentation

Examples​

# Show help and available commands
sos --help

# Show version information
sos --version

# Use custom API endpoint
sos --api-url https://api.custom.signageos.io applet list

Since​

0.1.0

Global Options​

All commands support the following global options:

OptionAliasDescription
--help-hDisplay help information for any command
--version-vDisplay the installed version of the CLI
--api-url-uOverride the API URL for REST requests
--profileUse a specific profile from ~/.sosrc config

Examples​

# Show version
sos --version

# Get help for any command
sos applet --help
sos applet upload --help

# Use custom API endpoint
sos --api-url https://api.example.com applet upload

# Use specific profile
sos --profile production organization list

See Also​