Skip to content

SightLab Example Scripts Dashboard

A browsable, searchable interface for discovering, launching, and managing SightLab VR example scripts.

AI Agent

Getting Started

Launching the Dashboard

Double-click or run the entry point at the workspace root:

Example Scripts Dashboard.py

Requirements

  • PyQt5 installed
  • Vizard 8 (for running example scripts) — expected at C:\Program Files\WorldViz\Vizard8\bin\winviz.exe
  • BeautifulSoup4 (optional, recommended) — used for HTML metadata parsing; falls back to regex if not installed

User Interface

Main View

AI Agent

  • Toolbar — Search bar, card size slider (140–360px), Refresh button, Settings button
  • Category Tabs — Examples are organized into tabs:
  • Tools/Features
  • Experiment Templates
  • How-To's
  • Media & Stimulus
  • Additional Examples
  • Uncategorized
  • Card Grid — Responsive grid of cards showing thumbnail, title, and description
  • Status Bar — Shows count of visible examples vs. total

Card Interactions

  • Left-click a card to open its detail page
  • Left-click a group card to navigate into its children (with breadcrumb navigation)
  • Right-click a card for a context menu with quick actions (Run, Edit, Open Folder, etc.)

Detail Page

Shows full information about an example:

  • Large thumbnail (360×240)
  • Title, category, folder path, description, and tags
  • Available Actions grid with buttons for all applicable operations
  • "← Back to Library" buttons at the top and bottom

Available Actions

AI Agent

Button Description
▶ Run Launches the script in Vizard
▶ [Alternate] Runs an alternate script variant
⟲ Replay Runs the session replay script
⚙ Config Opens the configuration script in the editor
⬇ Download Downloads a remote example archive (for cloud-hosted examples)
✏ Edit Code Opens the primary script in the Vizard IDE
📁 Open Folder Opens the example folder in Windows Explorer
📋 Make Copy Copies the example folder to a chosen destination
🔗 Documentation Opens the online documentation page

The search bar filters cards across all tabs simultaneously, matching against title, description, tags, and category.

Themes

Toggle between Light and Dark mode using the checkbox in the header bar. Theme preference is saved automatically.

AI Agent

Settings

AI Agent

Click the ⚙ Settings button to configure:

  • Vizard Executable — Path to winviz.exe if not in the default location
  • Vizard Editor — Path to Vizard.exe IDE
  • Copy Destination — Default folder for the "Make Copy" action

Downloadable Examples

AI Agent

Some examples are hosted on Google Drive and don't have local folders. These appear in the dashboard with a ⬇ Download button instead of a Run button. When downloaded:

  1. The archive is extracted to ExampleScripts/_downloaded/
  2. Click Refresh to rescan — the example will then have full Run/Edit/Open actions
  3. Downloaded examples are treated like any other local example

Adding Your Own Folders

Any folders added to the ExampleScripts folder will show up (by default under "Uncategorized"). In the details page you can right click on the thumbnail to swap it out and click the pencil icon to edit the description.

AI Agent

AI Agent