CueWeb Tutorial

Learn how to use CueWeb’s web interface to monitor jobs, manage frames, and control your OpenCue render farm.

Table of contents
  1. Overview
    1. What you’ll learn
    2. Prerequisites
  2. Getting Started
    1. Accessing CueWeb
    2. Interface Overview
  3. Monitoring Jobs
    1. Viewing Your Jobs
    2. Understanding Job Status
    3. Find Problem Jobs
  4. Basic Job Management
    1. Pausing and Resuming Jobs
      1. Pause a Job
      2. Resume a Job
      3. What you’ll see in other states
    2. Pause and Resume Practice
    3. Adjusting Priority
    4. Managing Job Dependencies
    5. Visualizing the dependency graph
  5. Job Details and Frame Management
    1. Viewing Job Details
    2. Understanding Layers
    3. Working with Frames
      1. Frame Status Colors
      2. Frame Operations
    4. Frame Troubleshooting
  6. Advanced Search and Filtering
    1. Basic Search
      1. Simple Text Search
      2. Show-Shot Search
    2. Advanced Regex Search
      1. Regex Examples
    3. Search Results Management
    4. Search Practice
  7. Table Customization
    1. Column Management
  8. Real-time Monitoring
    1. Auto-refresh Settings
    2. Monitoring Best Practices
      1. Active Job Monitoring
      2. Problem Job Identification
  9. Mobile and Remote Monitoring
    1. Reaching CueWeb from a phone on the same network
    2. Mobile-specific UI affordances
    3. Clipboard, notifications, and external editor on LAN HTTP
  10. Submitting a job from CueWeb (CueSubmit tutorial)
    1. Open CueSubmit
    2. Single-layer Shell submission
    3. Multi-layer chain with a Layer dependency
    4. Maya / Nuke / Blender layers
    5. Convenience features
  11. Troubleshooting Common Issues
    1. Frame Failures
    2. Performance Issues
    3. Additional Resources

Overview

This tutorial will guide you through using CueWeb, OpenCue’s web-based interface. You’ll learn how to monitor jobs, manage frames, search for specific jobs, and perform common render farm operations through your browser.

What you’ll learn

  • How to navigate the CueWeb interface
  • Job monitoring and management techniques
  • Frame-level operations and troubleshooting
  • Search and filtering capabilities
  • Team collaboration features

Prerequisites

  • CueWeb deployed and accessible
  • OpenCue render farm with some test jobs
  • Basic understanding of render farm concepts

Getting Started

Accessing CueWeb

  1. Open your web browser
  2. Navigate to your CueWeb URL (e.g., http://cueweb.company.com:3000)
  3. If authentication is enabled, sign in with your credentials

You should see the main CueWeb dashboard with the jobs table.

Interface Overview

The CueWeb interface consists of:

  • Global header (persistent across every authenticated route):
    • OpenCue logo (theme-aware: black in light mode, white in dark mode) + the CueWeb wordmark on the left, clickable as a link back to the jobs dashboard.
    • Six dropdown menus mirroring the CueGUI menu bar:
      • File -> Disable Job Interaction (read-only safety toggle).
      • Cuebot Facility -> switch between the options (e.g.: local / dev / cloud / external); the active facility is shown as a chip on the trigger.
      • Cuetopia -> Monitor Jobs.
      • CueCommander -> Allocations, Limits, Monitor Cue, Monitor Hosts, Redirect, Services, Shows, Stuck Frame, Subscription Graphs, Subscriptions. Routes that are not yet implemented 404 gracefully.
      • Other -> Attributes (toggles the docked Attributes panel), Show Shortcuts (opens the same overlay as ?), Notify on Shortcut (toggle for the per-shortcut toast).
      • Help -> a search box that finds commands across every menu, plus Online User Guide, Make a Suggestion, and Report a Bug.
    • Theme toggle and an always-visible Sign out button on the right. With an active session, Sign out clears it and returns you to /login. Without a session (or when auth is disabled), it simply navigates to /login.
  • Left sidebar (persistent, collapsible): same six groups as the header, organized as accordion sections. The group containing the active route auto-expands; click Collapse at the bottom to shrink the sidebar to an icon rail (your choice persists).
  • Read-only banner: appears only when Disable Job Interaction is on; describes the read-only state and offers a Re-enable button. Destructive toolbar buttons and right-click menu items are dim and inert in this state.
  • Attributes panel: docked drawer toggled from Other ▸ Attributes. Click a row in the jobs table to populate it; use the title-bar position picker to dock it on the right, bottom, left, or top of the viewport.
  • Breadcrumb (detail pages only): above the frame log and the per-job comments page, a small “Home > Jobs > …” trail lets you click back to the jobs index or to any parent in the path. Long labels truncate with an ellipsis; hover any segment to see the full text.
  • Bottom status bar: fixed 24-pixel bar at the bottom of every page. Shows REST gateway status (a dot + Online/Offline + round-trip latency), the time since the jobs table last refreshed, and the CueWeb build version. The whole bar turns red when the gateway is unreachable.
  • Filter Bar: Show selection, status filters, and search
  • Jobs Table: Main view of all jobs with sortable columns
  • Action Buttons: Job control operations

The login page:

CueWeb login page

The Dashboard:

CueWeb dashboard

The Cuetopia Monitor Jobs view, with the collapsible left sidebar:

CueWeb Monitor Jobs

CueWeb left sidebar


Monitoring Jobs

Viewing Your Jobs

  1. Select Your Show: Use the show dropdown to filter jobs for your project
  2. Apply Status Filters: Click filter buttons to show only:
    • Active jobs (running or pending)
    • Paused jobs
    • Failed jobs
    • All jobs
  3. Sort Jobs: Click column headers to sort by:
    • Priority (highest first)
    • Progress (completion percentage)
    • Start time (newest first)
  4. Inspect Per-state Progress: Hover the progress bar in the Progress column to display a tooltip with the exact frame count and percentage for each state (succeeded, running, waiting, depend, dead).

  5. Subscribe to Job Completion - in-browser: Click the bell in the Notify column to subscribe to a notification when a job reaches FINISHED. The bell cycles through three visual states:
    • Outline bell → not subscribed
    • Filled bell → subscribed, waiting
    • Filled bell with green dot → notification has fired (click to clear)

    The subscription always succeeds; the OS-level notification permission is requested afterward as an optional upgrade. A toast tells you the outcome - granted (in-app + desktop popup), denied (in-app only), or default (in-app only, user dismissed the prompt). Subscriptions are saved in your browser and survive page reloads, and a background check runs on each subscribed job every 15 seconds. The bell is disabled on jobs that are already FINISHED when first viewed.

  6. Subscribe to Job Completion - by email: For notifications that survive closing the browser or that should go to a team alias, right-click the job row and pick Subscribe to Job. A small dialog opens with the job name, an informational From address, and an editable To address (pre-filled with your account email).

    Subscribe to Job entry in the right-click menu

    Subscribe to Job dialog

    Adjust To if you want notifications sent somewhere else and click Save. A toast confirms the address has been registered with Cuebot; the email arrives from Cuebot when the job finishes.

    Subscribe to Job success confirmation

    The Notify bell and Subscribe to Job are independent - the bell lives in your browser, the email subscription lives on Cuebot. You can use either or both at the same time.

Understanding Job Status

Jobs are color-coded for quick identification:

  • 🟢 Green: Jobs with running frames
  • 🔵 Blue: Paused jobs
  • 🟠 Orange: Pending jobs waiting for resources
  • 🔴 Red: Jobs with failed frames
  • ⚫ Gray: Completed jobs

Find Problem Jobs

  1. Click the “Failed” filter to show jobs with errors
  2. Look for jobs with red status indicators
  3. Note the frame counts in the Progress column
  4. Sort by “Dead Frames” to prioritize the most problematic jobs

Basic Job Management

Pausing and Resuming Jobs

Sometimes you need to pause jobs to free up resources or fix issues. The context menu shows a single Pause/Unpause entry whose label reflects the job’s current state - Pause when the job is running, Unpause when the job is already paused, and grayed out when the job is Finished.

Pause a Job

  1. Find the job you want to pause (anything that is not already Finished or Paused).
  2. Right-click the row - the entry will read Pause.
  3. Click Pause.
  4. The job status changes to “Paused” with a blue indicator, and the next time you right-click the row the same entry will read Unpause.

Resume a Job

  1. Find a paused job (blue indicator).
  2. Right-click the row - the entry will read Unpause.
  3. Click Unpause.
  4. The job returns to In Progress (or Failing / Dependency if it has dead frames or unmet dependencies).

What you’ll see in other states

  • In Progress, Failing, Dependency: entry reads Pause and is active.
  • Paused: entry reads Unpause and is active.
  • Finished: entry reads Pause but is grayed out - a completed job cannot be paused.

Pause and Resume Practice

  1. Find an active job with running frames.
  2. Right-click and choose Pause - watch the status change to Paused.
  3. Wait 30 seconds for the interface to refresh.
  4. Right-click again - the entry now reads Unpause.
  5. Choose Unpause and observe how the job returns to the queue.

Adjusting Priority

Set Priority… is available everywhere the job context menu appears - both Cuetopia → Monitor Jobs and CueCommander → Monitor Cue. The walk-through below uses Cuetopia.

  1. Right-click any job row in Monitor Jobs and pick Set Priority….

    Set Priority entry in the right-click menu

  2. A themed dialog opens with a 1-100 slider and a matching number input. Either control drives the value; both stay in sync. The current priority is pre-filled (cuebot’s default is 100). Higher numbers dispatch first.

    Set Priority dialog with slider and number input

  3. Drag the slider to 50 (or type a value) and click Apply.
  4. A toast confirms the change. The Priority column in the Jobs table updates immediately - no need to wait for the regular 5-second refresh tick.

    Set Priority success confirmation toast

Managing Job Dependencies

The job context menu groups four dependency actions so you can audit, create, or remove depends on a job without leaving Monitor Jobs.

  1. Right-click any job row in Monitor Jobs.

  2. Review what’s blocking the job. Pick View Dependencies… to open a read-only dialog listing every depend on the job. Columns mirror CueGUI’s DependDialog: Type (e.g. JOB_ON_JOB), Target (INTERNAL or EXTERNAL), Active (boolean), and the OnJob / OnLayer / OnFrame identifiers. Click Refresh to re-poll the list, or Close to dismiss.

    View Dependencies entry in the job context menu

    View Dependencies dialog

  3. Add a new depend. Pick Dependency Wizard… to open the wizard.

    Dependency Wizard entry in the job context menu

    The wizard implements every CueGUI depend.DependType (Job On Job, Job On Layer, Job On Frame, Frame By Frame for all layers / Hard Depend, Layer On Job / Layer / Frame, Frame By Frame, Frame On Job / Layer / Frame, and Layer on Simulation Frame). Step count scales with the chosen type - the simplest (Job On Job) is three steps, the longest (Frame On Frame) is seven. Every picker is multi-select; Done fires the full source x target cross-product in one batch.

    The simplest path - Job On Job - has three steps:

    • Step 1: pick the dependency type.

      Job On Job step 1

    • Step 2: pick the target job(s) the current job should depend on.

      Job On Job step 2

    • Step 3: confirm the summary and click Done. A success toast confirms the depend was created.

      Job On Job step 3 - confirmation

    Per-type walk-throughs for every other depend type (with screenshots of every step) live in the Dependency Wizard dialog reference.

  4. Remove depends in one click. Pick Drop External Dependencies to remove every cross-job depend, or Drop Internal Dependencies to remove every within-job depend. Both surface a success toast and trigger an immediate re-poll of the Jobs table plus a refresh of the Group-By Dependent tree, so the chevrons and DEPENDENCY-state rows update without waiting for the autoload tick.

    Drop External Dependencies entry in the job context menu

    Drop External Dependencies success toast

    Drop Internal Dependencies entry in the job context menu

    Drop Internal Dependencies success toast

Visualizing the dependency graph

When you want to see a render chain rather than read a table of depends, turn on the Job Dependency Graph - a read-only node graph mirroring CueGUI’s Monitor-Jobs dependency-graph dock.

  1. Enable the graph. Open the Cuetopia menu (header dropdown or sidebar) and click View Job Graph. The entry is a checkable toggle - a check mark appears when it is on, and the choice is remembered across pages, tabs, and reloads.

    View Job Graph entry in the Cuetopia menu

  2. Open a job. Click a job row in Monitor Jobs. The graph mounts as a third panel under the inline Layers and Frames panels. It walks the job’s depends in both directions - what the job depends on and what depends on the job - and lays the result out top-to-bottom.

    Dependency graph panel below the inline Layers and Frames panels

  3. Read and navigate the graph. Each node carries a kind label (JOB / LAYER / FRAME) and a color-coded left border; the job you opened the panel for is ringed. Hover a node to see its full name, and click a node to open that job’s detail page. Use the corner controls to pan, zoom, and fit. Collapse or close the panel from the Dependency Graph button above Layers or the panel’s × button. A job with no depends shows No dependencies found for this job.

    The dependency graph panel on its own


Job Details and Frame Management

Viewing Job Details

CueWeb has two ways to inspect a job:

  1. Inline panel (quick look): Click a job row in the Jobs table. The associated Layers and Frames tables appear stacked just below the Jobs grid - the CueGUI Monitor Jobs + Monitor Job Details dock layout.

  2. Tabbed detail page (full inspection): Right-click a job and choose View Job Details (or tap the row’s Actions button on a phone). This opens /jobs/<jobName> with five tabs:
    • Overview: identity, frame and resource summary.
    • Layers: full Layers table.
    • Frames: full Frames table with the same filter chips and column controls.
    • Comments: preview of the job’s comments with a link out to the full Comments editor.
    • Dependencies: placeholder for the dependency graph view. The active tab is stored in the URL as ?tab=<key>, so the page is bookmarkable and the browser back / forward buttons walk between tabs.
  3. To view notes attached to a job, open Comments:
    • Right-click the job row and choose Comments, or click the sticky-note icon in the Jobs table’s dedicated Comments column (right after Name) when the job already has comments.
    • The Jobs table’s Comments column is sortable - click the column header to pull jobs with comments to the top.
    • The Comments page mirrors the CueGUI Comments dialog: comment list (Subject / User / Date), a markdown-rendered preview, an editor for the selected comment, and New / Save changes / Delete buttons.
    • A Use a predefined comment… dropdown applies, adds, edits, or deletes per-browser comment macros.
    • Only a comment’s author may edit or delete it; other users see it read-only.

The View Job Details menu item and the tabbed detail page (Overview / Layers / Frames):

CueWeb View Job Details menu

CueWeb Job Details overview tab

CueWeb Job Details layers tab

CueWeb Job Details frames tab

Understanding Layers

Each job contains one or more layers representing different render passes:

  1. Layer Information:
    • Layer name and type
    • Frame range (start-end frames)
    • Core and memory requirements
    • Progress statistics
  2. Layer Actions:
    • Kill all frames in layer
    • Retry failed frames
    • View frame details

Working with Frames

Frames are the individual rendering tasks within each layer.

Frame Status Colors

  • 🟢 Green: Successfully completed
  • 🟡 Yellow: Currently running
  • 🔴 Red: Failed frames
  • ⚫ Gray: Waiting/pending
  • 🔵 Blue: Being retried

Frame Operations

  1. View Frame Logs:
    • Double-click anywhere on the frame row to open the in-browser Monaco log viewer.
    • Or right-click → View Log / Tail Log for the same in-browser viewer.
    • On touch devices, tap the row’s Actions button (leftmost cell) → View Log.
    • Select log version from the dropdown inside the viewer.
    • The viewer shows an empty-state message when the frame hasn’t started running yet (no log file on disk).
  2. Open Logs in an External Editor (optional):
    • If the deployment has NEXT_PUBLIC_LOG_EDITOR_URL configured, the Frame right-click menu also offers View Log on <editor> below View Log.
    • The sandbox docker-compose.yml ships with vscode://file{path} as the default → View Log on VSCode. Override the build arg to target Sublime / TextMate / IntelliJ instead (or set it empty to hide the item).
    • Tapping it launches the rqlog file directly in your desktop editor via the custom URL scheme - the same approach GitHub’s “Open in VSCode” button uses. No need to copy the path and paste it into a terminal.
    • If the editor isn’t installed (no app registered for vscode://, subl://, etc.), CueWeb shows a warning toast after a short timeout pointing you at the alternatives.
  3. Retry Failed Frames:
    • Right-click on red (failed) frames
    • Select “Retry Frame”
    • Monitor the frame as it re-enters the queue
  4. Kill Running Frames:
    • Right-click on yellow (running) frames
    • Select “Kill Frame”
    • Use when frames are stuck or consuming too many resources
  5. Copy frame metadata:
    • Copy Frame Name copies just the frame name (e.g. 0001-test_layer).
    • Copy Log Path copies the absolute rqlog path so you can paste it into a terminal or another viewer.
    • Both work on plain-HTTP LAN deployments (e.g. accessing CueWeb on your phone via the Mac’s LAN IP), not just localhost.
  6. Filter by Frame State:
    • The chips above the frames table — WAITING, RUNNING, SUCCEEDED, DEAD, EATEN, DEPEND — show the count for each state and act as toggles.
    • Click one or more chips to filter; multiple selections are combined with OR.
    • The current selection is mirrored to the URL as ?frameStates=..., so the filtered view can be bookmarked or shared.
    • Counts on each chip always reflect the full unfiltered data set.

The frame right-click menu, and the confirmation toast shown after an action:

CueWeb frame context menu

CueWeb frame action success notification

Frame Troubleshooting

  1. Open job details for a job with failed frames
  2. Click on the “Frames” tab
  3. Find a red (failed) frame
  4. Click on the frame number to view logs
  5. Look for error messages in the log output
  6. Right-click the frame and select “Retry”
  7. Watch the frame change from red to gray (pending)

Advanced Search and Filtering

The search bar supports multiple search patterns. As you type, a dropdown suggests matching jobs you can pick from:

CueWeb job search

CueWeb job search pick from list

# Find jobs containing "comp"
comp

# Find jobs starting with show name
myshow-

# Find specific shot
shot_010
# Find jobs by show-shot pattern
show-shot-

# Find specific shots
myshow-shot_010-

Prefix searches with ! to enable regex patterns:

Regex Examples

# Find jobs matching pattern
!^myshow-.*comp.*$

# Find jobs with specific frame ranges
!.*_[0-9]{3}-[0-9]{3}_.*

# Find jobs by multiple criteria
!(lighting|comp).*shot_[0-9]+

Search Results Management

  1. View Suggestions: Type to see dropdown suggestions
  2. Add to Monitor: Click to add jobs to your dashboard
  3. Green Indicators: Shows jobs already in your monitor
  4. Batch Selection: Use checkboxes for multiple jobs

Search Practice

  1. Basic Search:
    • Type your show name followed by a hyphen
    • Note the dropdown suggestions
    • Select a job to add to monitoring
  2. Show-Shot Search:
    • Search using show-shot- pattern for show-based filtering
    • Try myshow- to find jobs from a specific show
  3. Regex Search:
    • Use !.*lighting.* to find lighting jobs
    • Try !^[a-z]+_shot_[0-9]+ for pattern matching

Table Customization

Column Management

Each of the three data tables (Jobs, Layers, Frames) has its own Columns dropdown in the per-table toolbar.

CueWeb column visibility dropdown

  1. Show / Hide columns:
    • Open the Columns dropdown.
    • Toggle the checkbox next to any column to hide / show it.
  2. Reorder columns left / right:
    • In the same dropdown, each row has a button (move column one slot left) and a button (move it one slot right). Non-hideable system columns (the row-select checkbox) stay anchored, so swaps never reach across them.
  3. Reset to default:
    • The pinned Reset to Default button at the top clears both column visibility AND order in one click.
  4. Filter the loaded rows:
    • The Filter … input next to the Columns dropdown performs a case-insensitive substring search across every visible column and narrows the rows already loaded. The table snaps back to page 1 on every keystroke; click the × button to clear the filter.
  5. Sort:
    • Click any sortable column header to toggle ascending / descending.

Both visibility and ordering choices are saved per table in your browser and survive reloads, navigations, and redeployments.

Real-time Monitoring

Auto-refresh Settings

  • Refresh Interval: CueWeb uses a fixed 5-second update interval for all tables.
  • Job-finished Notifications: Subscribe to specific jobs via the bell in the Notify column. A background poller checks each subscribed job every 15 seconds. When the job reaches FINISHED an in-app toast fires (always), and a desktop popup is layered on top when you have granted the browser’s notification permission. Subscriptions are saved in your browser and survive page reloads; when several tabs are open for the same job, only one tab shows the notification.

Monitoring Best Practices

Active Job Monitoring

  1. Filter to Active Jobs: Hide completed jobs for focus
  2. Sort by Priority: High-priority jobs at the top
  3. Watch Progress: Monitor completion percentages
  4. Check Failed Counts: Red numbers indicate problems

Problem Job Identification

  1. Failed Frame Alerts: Look for red indicators
  2. Stuck Jobs: Jobs with no progress over time
  3. Resource Hogs: Jobs using excessive memory/cores
  4. Long-running Frames: Individual frames taking too long

Mobile and Remote Monitoring

CueWeb is responsive down to phone-sized viewports. Every action available on desktop has a mobile-equivalent path.

Reaching CueWeb from a phone on the same network

  1. On the machine running CueWeb, find the LAN IP: ipconfig getifaddr en0 on macOS, ip a on Linux.
  2. On the phone (same Wi-Fi), open http://<lan-ip>:3000 in your browser (e.g. Safari or Google Chrome).
  3. The same UI loads. The client builds same-origin relative URLs for every API call, so it works correctly from any host (no rebuild needed). This requires NEXT_PUBLIC_URL= (empty, the default).

Mobile-specific UI affordances

  1. Hamburger nav drawer:
    • The desktop sidebar is hidden below the md breakpoint (768px).
    • A hamburger button appears on the LEFT of the global header. Tap it to open a side drawer with every group: Dashboard, File, Cuebot Facility, Cuetopia, CueCommander, Other (Attributes / Show Shortcuts / Notify on Shortcut), Help.
    • The drawer auto-closes when you tap a navigation link.
  2. Per-row Actions menu (replaces right-click):
    • Every Jobs / Layers / Frames row has a small button as its leftmost cell.
    • Tap it to open the same context menu the desktop right-click opens: Copy Job / Layer / Frame Name, View Log, View Log on <editor>, Pause / Kill / Eat / Retry, etc.
  3. Horizontally swipeable tables:
    • The Jobs / Layers / Frames grids have 15-25 columns each. Phones can’t fit all of them.
    • Swipe left/right inside the table to reach off-screen columns.
    • Use the Columns dropdown to hide columns you don’t need on small screens (the choice is remembered for next time).
  4. Tap-to-trigger keyboard shortcuts:
    • Open Other ▸ Show Shortcuts from the hamburger drawer.
    • Every key badge in the overlay is a real button. Tapping / focuses the Jobs search box, r refreshes the table, t toggles theme, Esc closes the overlay - no physical keyboard needed.

Clipboard, notifications, and external editor on LAN HTTP

  • Clipboard works on plain-HTTP LAN access. The browser’s modern clipboard API is restricted to secure contexts (HTTPS / localhost), but CueWeb automatically uses a legacy copy path when the modern one isn’t available.
  • Subscribe to Job still works - the in-app toast always fires. The optional desktop popup is skipped on LAN HTTP because the Web Notifications API also requires a secure context; serve CueWeb over HTTPS (self-signed cert is enough) to enable that path.
  • View Log on <editor> depends on the user’s device having the URL scheme registered. iOS Safari doesn’t route arbitrary custom schemes to apps the way macOS does, so the in-browser View Log is the reliable path on phones - CueWeb falls back to a warning toast when the scheme isn’t handled.

Submitting a job from CueWeb (CueSubmit tutorial)

This walkthrough mirrors what you would do in the standalone CueSubmit CLI tool, but inside the browser. It assumes the OpenCue sandbox is running on localhost:3000 and you have the testing show registered in cuebot (the default seed data includes it).

Open CueSubmit

Click CueSubmit > Submit Job in the top header. The form opens at /cuesubmit with three main sections (Job Info, Layer Info, Submission Details) plus a read-only Final command preview between them.

CueSubmit menu options

CueSubmit Submit Job page

Single-layer Shell submission

  1. Job Info
    • Job Name: tutorial_shell
    • Show: pick testing from the dropdown
    • Shot: test_shot
    • Facility: leave as [Default]
    • Username: pre-filled when you’re signed in. If you want to submit as someone else, tick the Edit checkbox next to the field and type their name.
  2. Layer Info
    • Layer Name: layer1
    • Frame Spec: 1-3
    • Chunk Size: 1
    • Memory: 256m (the default; works on the sandbox RQD)
    • Job Type: Shell
  3. Shell options (the panel below Layer Info)
    • Command To Run: echo "frame #IFRAME#" && sleep 2. Click the ? next to the field for the cuebot token cheatsheet (#IFRAME# is the current frame number).
  4. Watch the Final command preview at the bottom of the panel update per-keystroke. This is exactly what cuebot will execute on each frame.
  5. Click Submit. CueWeb redirects to the job detail page; the three frames cycle WAITING -> RUNNING -> SUCCEEDED in a few seconds.

Multi-layer chain with a Layer dependency

Use the multi-layer table at the bottom of the form (the Submission Details section) to chain layers.

  1. Set up the first layer as above (Layer Name preview, Job Type Shell, Command echo preview frame #IFRAME#).
  2. Click the + button under the Submission Details table to add a second layer.
  3. The Layer Info section now edits the new layer. Set Layer Name final, Frame Spec 1-3, Job Type Shell, Command echo final frame #IFRAME#. In the Dependency Type dropdown pick Layer so the final layer waits for preview to fully finish.
  4. The table at the bottom now shows two rows. Click either row to flip the editor between them; use ↑ / ↓ to reorder; use to drop the selected layer.
  5. Submit. The detail page shows both layers; final stays in DEPEND state until preview completes, then dispatches.

Maya / Nuke / Blender layers

Flip Job Type to Maya, Nuke, or Blender to swap the per-type options panel:

  • Maya asks for a Maya File (.ma / .mb) and an optional Camera. The Final command becomes Render -r file -s #FRAME_START# -e #FRAME_END# [-cam CAM] <file>.
  • Nuke asks for a Nuke File (.nk) and optional comma-separated Write Nodes. The Final command becomes nuke -F #IFRAME# [-X WriteNodes] -x <file>.
  • Blender asks for a Blender File (.blend), an Output Path, and an Output Format. Simple ranges (1-10) use -s/-e/-a; more complex ranges use the per-frame -f #IFRAME# token.

The CueWeb panel always preserves the inputs you typed even when you flip between types, so iterating doesn’t lose your scene path or camera.

Convenience features

  • Autocomplete history: start typing in Job Name, Shot, or Layer Name to pull values you’ve used before. The list is kept per-browser, deduped, capped at 25 entries.
  • Auto-saved draft: the form’s full state is saved on every keystroke. Refresh the tab - the layers you had configured are still there. The draft is cleared on Cancel, on Reset (after a confirm dialog), and after a successful submit.
  • Reset: the Reset button between Cancel and Submit clears every field after a themed confirmation dialog. Autocomplete history is not wiped.
  • View in Monitor Jobs: from the detail page that opens after submit, click View in Monitor Jobs in the header to deep-link to Cuetopia with the new job auto-loaded.

Troubleshooting Common Issues

Frame Failures

When frames fail repeatedly:

  1. Check Frame Logs:
    • Click failed frame numbers
    • Look for error patterns
    • Note resource usage
  2. Common Issues:
    • Memory errors: Frames running out of RAM
    • File not found: Missing assets or incorrect paths
    • License errors: Software license unavailable
    • Timeout errors: Frames taking too long
  3. Resolution Steps:
    • Retry individual frames
    • Adjust memory requirements
    • Check asset availability
    • Contact technical support

Performance Issues

When jobs run slowly:

  1. Check Resource Allocation:
    • Verify core and memory settings
    • Look for resource conflicts
    • Monitor host utilization
  2. Optimization Strategies:
    • Increase priority for urgent jobs
    • Pause non-critical jobs
    • Adjust core allocations
    • Balance workload across hosts

Additional Resources


Back to top