🏃 Getting started

warning

Ensure you have an active Python venv in a terminal window.

info

Learn how to activate 🔮 virtual environments

The 👁️‍🗨️ Visualisation module uses two services to run properly:

• Front service
• Power the user interfaces
• The default port is 5530
• Audio service
• Serve audio files from your file system
• The default port is 5531

🔗 Compatibility

While the web app is compatible with most browsers, we've encountered intermittent issues with Firefox on Windows 11 and Safari on macOS 14. For optimal performance, we recommend using Chrome.

🔧 cse_vis Command

This command initiates both the Audio and Front services.

In an active venv terminal, enter the following command to start both services (replace the path to your configuration file by dragging and dropping the configuration file icon into your terminal):

# Windows
cse_vis C:\path\to\config.xlsx

# Ubuntu / macOS
(venv)$> cse_vis /path/to/config.xlsx

After pressing <Enter>, both services will launch, and your default browser will open.

Windows screencast

note

You can alternatively use cse_viz as an alias for the cse_vis command.

🔧 cse_audio Command

Use the cse_audio command to start only the Audio service.

This can be useful in case you are using the 👁️‍🗨️ Visualisation online.

# Windows
cse_audio C:\path\to\config.xlsx

# Ubuntu / macOS
(venv)$> cse_audio /path/to/config.xlsx

🔧 Advanced Commands

audio:front Command

Simultaneously start both the Front and Audio services.

pnpm audio:front relative/or/absolute/path/to/audio/folder

audio Command

Start the Audio service on port 5531.

pnpm audio -- relative/or/absolute/path/to/audio/folder

front Command

Start the Front service on port 5530.

pnpm front