System Configuration

The System Config section, accessible from the top navigation bar, provides system-wide configuration options including user management, RBAC settings, system settings, and show management.

System Tab

The System tab provides an overview of the current system state:

• Current Show: Displays the currently loaded show name, with buttons to load an existing show or set up a new one.
• Connected Clients: Shows the number of WebSocket clients currently connected to the server. Click “View Clients” to see details about each connected session.
• Version: Displays the current DigiScript version and checks for available updates.

Version Checker

The version checker automatically checks for new DigiScript releases when the server starts, and periodically (every hour) thereafter. The version status shows:

• Current version: The version of DigiScript currently running
• Status badge: Indicates whether you’re up to date (green), an update is available (yellow), or the check failed (red)
• Latest version: When an update is available, shows the newest version number with a link to the release notes
• Last checked: Timestamp of when the version was last checked

Click the Check Now button to manually trigger a version check against the GitHub releases.

System Settings

The Settings tab allows you to configure system-wide settings that apply across all shows:

These settings control global application behavior and defaults. Settings configured here apply system-wide unless overridden at the user or show level.

Users and RBAC

DigiScript allows you to create system-wide users and configure Role Based Authorization (RBAC) to control their access to shows and resources. This is an optional feature - the admin user created during application first launch has permissions to perform all actions and can be used as the sole administrator. However, adding users allows you to delegate specific permissions for tasks like configuring shows, editing scripts, or managing cues.

Managing Users

To configure users, a show must first be loaded. Navigate to the System Config page from the top navigation bar, then select the Users tab. This displays a table of all system users:

The users table shows:

• Username
• First and Last Name
• Last Seen timestamp (when the user was last active)
• Actions (Edit, Delete, RBAC configuration)

Creating Users

Click the New User button to add a new user. You’ll need to provide:

• Username (must be unique across the entire system)
• Password
• First Name
• Last Name

Users are created at the system level and are not tied to individual shows. Their access to specific shows and resources is controlled through RBAC configuration.

Configuring RBAC

Once users have been created, their permissions can be configured by clicking the RBAC button next to each user. This opens a detailed permissions interface where you can:

• Grant or revoke access to specific shows
• Set permissions per resource type (e.g., Shows, Scripts, Cue Types)
• Configure fine-grained permissions per specific resource (e.g., write access to lighting cues but not sound cues)

RBAC configuration determines what shows a user can access and what actions they can perform within those shows.

Backup Management

The Backups tab allows admin users to view and manage database backup files. DigiScript automatically creates a timestamped copy of the database file before running any database migration, ensuring you can recover data if a migration causes issues.

The tab displays:

• A summary line showing the total number of backups and combined disk usage
• A table listing each backup file with its filename, size, and creation date

To delete a backup, click the Delete button next to it and confirm the action. Deletion is permanent and cannot be undone.

Note: Backup files accumulate over time as you upgrade DigiScript. Periodically reviewing and removing old backups helps reclaim disk space once you are confident the corresponding migrations completed successfully.

RBAC Roles and Mappings

The current RBAC mappings are as follows:

• Shows:
  • Read: Unused
  • Write: Create, edit, delete show resources such as acts, scenes, characters etc
  • Execute: Start and stop show sessions (See Live Show)
• Cuetypes:
  • Read: Unused
  • Write: Create, edit and delete cues of a particular type
  • Execute: Unused
• Script:
  • Read: Unused
  • Write: Make changes to the script
  • Execute: Unused