Skip to main content

Transpiler

The Hosanna Compiler (hsc) is responsible for transpiling TypeScript projects to other platforms, including Roku. It reads your project configuration from the hsconfig.json file (see the configuration section elsewhere in the documentation for details).

Overview​

The Hosanna Transpiler is a command-line tool that converts your TypeScript codebase into Roku's BrightScript language, enabling modern development workflows for Roku applications. The tool is designed to be fast, reliable, and easy to integrate into your development process.

Usage​

To see all available options, run:

hsc --help

You will see output similar to:

hosanna-transpiler: Version: 0.21.2 (build date: 2025-08-04T18:53:04Z)
hsc

Hosanna transpiler — Converts TypeScript into Roku's BrightScript language
Version: 0.21.2
Build Date: 2025-08-04T18:53:04Z

Options:
  --version      Show version number                                   [boolean]
  --help         View help information about this tool.                [boolean]
  --project      Path to a hsconfig.json project file.                  [string]
  --fingerprint  Print this machine’s fingerprint for license activation.
                                                                       [boolean]
  --licenseHelp  Print instructions to activate your license.          [boolean]
  --update       Check for updates and install the latest version if available.

  • --version Prints the current version of the transpiler.

  • --help Displays help information about available options and usage.

  • --project Allows you to specify the path to a hsconfig.json project file. This is useful if your configuration is not in the default location.

  • --fingerprint Prints your machine’s fingerprint, which is used for license activation.

  • --licenseHelp Prints instructions for activating your license.

  • --update Checks for updates and installs the latest version if available.

The version and build date are included in the output to help you verify you are using the correct version of the transpiler for your project.

For more details on configuring your project, see the hsconfig.json documentation.