TABLE OF CONTENTS

• Overview
• Backstage
  • Home tab
  • Account tab
  • Settings tab
• Main workspace
• Keyboard shortcuts
• General notes about the user interface

Overview

The Casambi Pro user interface consists of two main views: 

• Backstage where projects are listed, and project and application-level settings can be accessed.
  • In Pro for Windows, it is possible to navigate between the Backstage and Main Workspace views when a project is open.
  • In Pro for iPad/iPhone, project is closed when user navigates from Main Workspace to Backstage, or from Casambi Pro to another iOS application.
• Main workspace where the project contents is created and edited.

Backstage

Home tab

Windows

1. Side ribbon, with options
   • Home: List of projects
   • New: Create new project
   • Join: Insert invitation code to join a project
   • Visible if a project is open:
     • Project: Details for currently open project 
     • Export report…: Export project documentation
     • Save: Saving the currently open project
     • Close: Closing the currently open project
   • Account: Sign In/Out from Casambi Pro
   • Settings: Application-level settings and information about Casambi Pro
2. List of projects user has created, or which have been shared with him/her. 
   • Project list can be updated with the Refresh button. 
   • Project list can be sorted by clicking the column titles.
3. Project list columns:
   • Name: Name of project
   • My role: User’s role in project (in first version: Owner or Editor)
   • Current editor: Shows if a project is currently open and who is editing it.
   • Status: Shows the lock status and the device name in which the project is locked. Status columns is empty if project is not edited by anyone.
   • Last edited: Date and time when the project was last saved
   • Last edit by: Name of the latest editor
4. Project can be deleted by using the trash can icon if
   • User has the Owner role
   • The project is not currently open

iPad

The Backstage view in iOS is arranged in the same way as in Casambi Pro for Windows, with some exceptions:

• Home tab:
  • Project list is updated by dragging the list downwards with finger (there is no separate refresh button in iOS)
  • Projects cannot be deleted with iOS
• When user navigates from Main Workspace to Backstage view, current project is closed. 
• Project level properties (project name, location etc.) cannot be browsed or edited (feature coming later).
• Projects cannot be shared in iOS.

Account tab

The Account tab is used for signing in and out of Casambi Pro.

Settings tab

All application-level settings are collected into the Settings view. Here is also a collection of links to Casambi Pro online resources.

NOTE: In some Casambi Pro releases, this view can include access to use some early BETA Preview features, which will be displayed under a separate “Beta Features” title. These options may later be added as permanent features of Casambi Pro if they prove to be useful.  

Main workspace

The main workspace is quite similar in both Windows and iOS.

Windows

1. Top ribbon, with options
   • File: Navigation to the Backstage view.
   • Home: Tools for creating and managing project contents.
   • View: Tools for managing the workspace user interface and its colour theme.
2. Project Explorer pane, which lists the layouts and elements placed in them.
3. Layout view, where the floorplans and their overlay elements (spaces, luminaire groups, controllers and luminaires) are created and managed. Note, that luminaires appear in projects only after they are paired to the Pro networks on site.
4. Properties pane, displays properties for the currently selected object.
5. Scenes pane, displays scenes for the currently selected space. This pane appears empty if no space or any element in it is selected.
6. Network list, shows networks which have been created for the current project. 
7. Space templates pane, shows space templates created in the project.
8. Bottom bar, displays the app version number, last save time and transient status information e.g. while saving the project
9. Feedback button, for sending feedback to Casambi Pro development team.

Each pane can be 

• Closed and reopened
• Moved around the window
• Resized
• Stacked together with other panes
• Pinned to the sides of the window
• Detached to float outside the Casambi Pro window

The default arrangement of panes can be restored with the Reset Views option in the View ribbon. If the workspace layout Is changed by the user, it will be remembered the next time the app Is opened.

iPad

1. Home button for closing the project and navigating to Backstage
2. Buttons for toggling visibility of the Project Explorer, Networks list and Scenes panes.
3. Buttons for toggling visibility of the Property Pane and Nearby Devices list panes.
4. Left side pane shows either the Project Explorer or the Network list
5. Scenes for the currently selected space
6. Properties for the currently selected element

Notes related to Casambi Pro for iOS user interface

• The app works in both landscape and portrait orientations
• The app follows the system colour theme (light/dark)
• In iOS, the app does not have a pane for Space Templates, it is only in the Windows version
• On iPad, the Casambi Pro can be used with a mouse and a keyboard if those are available
• The user interface has not yet been optimized for the iPhone (Oct 2024)

Keyboard shortcuts

In Casambi Pro for Windows, some layout tools and features can be activated from the top ribbon and also by using keyboard shortcuts.

General notes about the user interface

Following notes are valid during the time of the October 2024 release. Casambi Pro is evolving constantly with regular updates, and it is highly recommended to read the Release Notes of each release to check the latest changes in the applications and to download the latest version of this user guide.

• Free text notes can be added to any element in the project: layout, network, space, luminaire group, controller, scene and cloud gateway. This can be done in both Windows and iOS. The notes are part of exportable project documentation.
• Deleting objects can be done with several methods. First, select an object and then
  • Click the trash can icon in selected object’s property pane
  • Click the trash can icon in the Home ribbon (Windows only)
  • Right-click object and select Delete in the context menu (Windows only)
  • Click Delete key in the keyboard (Windows only)

 When deleting an object, a confirmation message will be displayed (except If user Is deleting an empty space).

Note, that objects which contain real paired devices cannot be deleted before the paired devices have been unpaired from the network.

• In Casambi Pro for Windows, most objects have a context menu behind mouse right-click.
• In iOS, only paired luminaires have a context menu, providing the Identify command.
• Limitations in initial versions of Casambi Pro:
  • There is no Undo feature.
  • Projects cannot be reverted to previously saved version.
• iOS version’s user interface has not been optimized for the iPhone, thus the user experience on the phone is not optimal.