Search by Tags

Partner Demo Container - Crank Storyboard


Article updated at 16 Jan 2020
Compare with Revision

Subscribe for this article updates

Crank Storyboard - GUI Design & Development Software

Crank Software is the company that develops Crank Storyboard, a GUI design and development tool created exclusively for embedded systems. Storyboard’s designer-developer parallel workflow environment accelerates design iteration and the overall development process by up to 50% while retaining design vision with maximum performance.

Crank has now added support for the Toradex Linux platform Torizon. Supporting Toradex System on Modules based on the NXP® i.MX 6, i.MX 7 and i.MX 8

Crank Storyboard Container for Torizon

Crank Software has created a Storyboard Container for Torizon and uploaded it to Docker hub. Some of the advantages of using containers are as follows:

  • You can keep applications independent
  • Use different runtimes
  • Encapsulate application dependencies in the container
  • Maintenance and deployment is easier

Supported Modules

The following Computer on Modules are supported:

  • Apalis iMX8
  • Apalis iMX6
  • Colibri iMX7 (Coming Soon)
  • Colibri iMX6

Supported Displays

While you can use a wide variety of displays and monitors, additional configuration may be required for a specific setup.

A section at the end of this guide provides instructions about the display and touch screen configuration.

How to Get Started

This section provides instructions for you to quickly get started with Crank Storyboard.


  • Toradex SoM with Torizon installed. For instructions about how to install Torizon in your board, refer to Toradex Getting Started Guide
  • (helpful) Basic understanding of Docker and docker run command options
  • An HDMI screen connected to the Toradex SoM board. Optionally, you can use one of the supported displays.

Run a Weston Container

The Storyboard container has been built to interface with Weston, so we need to launch the Weston interface. Fortunately, this has been built into a handy container that can be downloaded and run.

Open a shell connection to the Torizon system (serial or ssh).

$ ssh torizon@<ip address>

Now you can run the Weston Container.

$ docker run -d -it --restart=always --privileged -v /tmp:/tmp -v /run/udev/:/run/udev torizon/arm32v7-debian-weston:buster weston-launch --tty=/dev/tty7 --user=root

Note: Note: This command will download the container and then run it, once it’s downloaded it will launch directly

Validate that the container is running by typing the following command

$docker ps
2911ace7f39f       torizon/arm32v7-debian-weston:buster  "/usr/bin/ w…"   14 minutes ago      Up 14 minutes      wizardly_jepsen

Run the Storyboard Container

Now we can run the Storyboard container working with the Weston interface. This has been configured to leverage the OpenGL hardware acceleration on the platform.

docker run -it --privileged -v /home/torizon/crank/scp:/usr/crank/scp -v /dev:/dev -v /tmp:/tmp cranksoftware/torizon_imx6:6_1

This container has been built to automatically launch one of our medical demo applications using the Crank Storyboard 6.1 release.

The following video shows the walkthrough of these steps and how you can deploy your own custom application using Storyboard.

Next Steps

Download your full-featured free trial of Crank Storyboard on Crank's Website.

Running the demo on a Display

For the displays recommended by Toradex, go to Setting up Recommended Displays with Torizon page.

Displays and Monitors used in Embedded Systems are available in a myriad of configuration possibilities - resistive, capacitive or without touch, single or multi-touch, different resolution, density of pixels, pin-out and clock frequency are some examples.

To make things easy for you, Toradex provides specific instructions on how to use its display offerings as well as comprehensive information about how to interface your custom display or monitor to Toradex modules.

There are three tested and recommended displays by Toradex:

You can easily set-up and get them running with 3 steps explained on Setting up Recommended Displays with Torizon. If you prefer to configure a specific display, it is suggested the reading about the easy to use Torizon device tree overlays container on Device Tree Overlays.

Related Articles

Release Notes

This release notes are strictly related to the test of the Crank Storyboard container in Toradex hardware.


  • Initial release.