Skip to content

Zelos App

The Zelos App is a tool for capturing and viewing tracing data on your computer.

Installing the Zelos App

Download the app using one of the following links:

Once you have downloaded and extracted the .zip, move Zelos.app to your Applications folder, and double-click to launch.

Install via Apt

Warning

Installing via Apt is currently only supported for Ubuntu 22.04 Jammy. The following instructions may work for other versions of Debian or Ubuntu, but have not been tested.

Run the following commands in a terminal to add the Zelos apt repository and install the Zelos app package.

echo "deb [arch=amd64 trusted=yes] https://release.zeloscloud.io/app/ubuntu jammy main" \
    | sudo tee /etc/apt/sources.list.d/zelos.list
sudo apt update
sudo apt install zelos-app

Launch the Application

zelos-app

Add Shortcut

Add to Favorites
Right click the Zelos App icon + Add to Favorites

Download the installer using one of the following links:

  • Windows (amd64)
  • If you are running Windows on an Arm processor, please contact us

Double click the installer, and the app should launch automatically.

If you see the message 'Something Went Wrong'

Install the latest Microsoft Visual C++ Redistributable from the the Microsoft website.

The latest VC Redist x64 can be found at https://aka.ms/vs/17/release/vc_redist.x64.exe

PCAN on Windows

If using a PCAN dongle on Windows to view CAN traffic, see driver install docs here: PCAN Driver Install

Updates

You will be notified of available updates via an "Update Available" button in the top right of the app window. It's also possible to manually check for updates via the "Updates" page in settings, accessible via the bottom left gear icon.

Viewing Live Data

Open the Zelos App and click the button "Connect Live" beneath the "Get Started" text. Viewing data from here next requires two steps:

  1. Telling your computer to start capturing data from a device.
  2. Creating plots out of the data that you have started capturing.

To accomplish the first task, navigate to the menu of the bottom left corner of the screen that says "Trace Capture" and select the file from the dropdown that contains the station configuration file you would like to use - there should be one loaded by default. Finally, click the "Play" button to the right of the dropdown.

If you have accomplished this task correctly, you should see a number of signals appear beneath the "Signals" column in the top-left corner of the screen. From there, you should be able to drag and drop them into the middle of the screen in order to view the relevant data in a plot.

To see data in the plot, move your mouse over it and look at the content within the tooltip.

See the Trace Capture documentation for more detail: Trace Capture

Logging in and Logging Out

When you first open the application, if you are not signed in, you will be taken to a log in screen. From here, you can click whichever of the three buttons you like to sign in.

Note that if you are already signed in, you will not be taken to the sign in screen until you sign out again.

Here is a video demoing the feature:

Saving and Viewing Layouts

After organizing the panels on your screen in a way that you find pleasing, you can save your work into a layout that can be shared with other people and applied to different sets of data.

To apply a layout that you or someone else on your team has created, click on the top of the application and click on the "Layouts" button. From there, browse down the list of layouts to pick the one you would like to apply. When you click it, it will configure your screen automatically.

To create a layout yourself, first move all of the panels into the places that you need them to be. Then, click on the layouts button at the top of the screen and click "Save As" at the top. From there, you will be taken to a dialog where you can enter a name and decide whether to share the layout with your organization or keep it personal; make the decisions you would like, and then click "Save." The layout will be stored in the cloud, and you will be able to access it as necessary.

You can delete a layout by clicking on the three dots on the right side of each element on the dropdown.

Here is a video demoing the feature:

Saving and Viewing Traces

While you are viewing the application in live mode, there is a button at the bottom right of the screen that will let you export traces. You can click it and select a name and folder in which to save the data that you are currently looking at on your computer.

To view the data that you were looking at, open the application and click the button "Open a Trace" beneath the "Get Started" text. From there, open the file that you have exported previously. You will be able to save the file that you have saved. You can also click the button at the top of the screen.

Here is a video demoing the feature:

Configuring your station

View data from the device(s) attached to your station by describing them in a config file. Once the config is selected, the app will fetch and plot data from your device(s).

See the Trace Capture documentation for more detail: Trace Capture

You can now edit your station configurations from the UI. If you click on "Select a Station Config" after opening a new workspace, you can see a list of the files that you have. If you click on one, that will select it. If you click on the dropdown again and then click "Edit", you can edit the settings by filling out the form in the file. You can also create a station config by clicking on the "Create" button after opening that dropdown.

Here is a video demoing the feature:

Managing Workspaces

Each time you open the Zelos App, the current state of the plots you were looking at will be saved into a "workspace" that you can come back to. To get back to these workspaces, you have two options:

  • When the app starts, click on the relevant workspace from the "Recently Viewed" menu on the right side of the screen.
  • Click the folder icon at the top of the screen.

If you would like to rename the current workspace that you are working on so that you can find it more easily, click on the text at the top of the screen and enter the name that you would like.

Demo

Here is a video showing an example session with the application using example data: