CueNIMBY tutorial

Step-by-step tutorial for configuring and using CueNIMBY

This tutorial guides you through setting up and using CueNIMBY to control your workstation’s rendering availability. You’ll learn how to install CueNIMBY, configure it for your environment, set up time-based scheduling, and integrate it with your daily workflow.

What you’ll learn

How to install and configure CueNIMBY
How to monitor your workstation’s rendering state
How to manually control rendering availability
How to set up time-based scheduling
How to customize notifications
How to integrate CueNIMBY with RQD

Prerequisites

OpenCue environment set up and running
Access to a Cuebot server
RQD running on your workstation (optional but recommended)
Basic familiarity with JSON configuration files

Step 1: Install CueNIMBY

1.1 Verify prerequisites

First, ensure you have Python 3.7 or later:

python --version
# or
python3 --version

You should see output like Python 3.9.x or higher.

1.2 Install OpenCue client libraries

If not already installed:

pip install opencue-pycue

1.3 Install CueNIMBY

From the OpenCue repository:

cd OpenCue/cuenimby
pip install .

1.4 Verify installation

cuenimby --version

You should see the CueNIMBY version number.

Checkpoint: CueNIMBY is installed and ready to use.

Step 2: First run and initial configuration

2.1 Start CueNIMBY

Run CueNIMBY from the terminal:

cuenimby --verbose

The --verbose flag helps you see what’s happening during first run.

2.2 Observe the output

You should see output similar to:

2025-10-01 10:00:00 - cuenimby - INFO - Starting CueNIMBY v1.0.0
2025-10-01 10:00:00 - cuenimby - INFO - Connecting to Cuebot at localhost:8443
2025-10-01 10:00:00 - cuenimby.config - INFO - Created config file: /home/user/.opencue/cuenimby.json
2025-10-01 10:00:00 - cuenimby.monitor - INFO - Connected to Cuebot
2025-10-01 10:00:00 - cuenimby.monitor - INFO - Monitor started
2025-10-01 10:00:00 - cuenimby.tray - INFO - CueNIMBY tray started

2.3 Find the tray icon

Look for the CueNIMBY icon in your system tray:

macOS: Menu bar (top-right corner)
Windows: Notification area (bottom-right corner, may be hidden)
Linux: System tray (location depends on desktop environment)

The icon color indicates your workstation’s current state.

2.4 Examine the configuration file

CueNIMBY created a default configuration file. Let’s look at it:

cat ~/.opencue/cuenimby.json

You should see:

{
  "cuebot_host": "localhost",
  "cuebot_port": 8443,
  "hostname": null,
  "poll_interval": 5,
  "show_notifications": true,
  "notification_duration": 5,
  "scheduler_enabled": false,
  "schedule": {}
}

Checkpoint: CueNIMBY is running and you can see the tray icon.

Step 3: Configure Cuebot connection

3.1 Stop CueNIMBY

Press Ctrl+C in the terminal where CueNIMBY is running, or right-click the tray icon and select “Quit”.

3.2 Edit the configuration

Open the configuration file in your text editor:

nano ~/.opencue/cuenimby.json
# or
vim ~/.opencue/cuenimby.json
# or
code ~/.opencue/cuenimby.json

3.3 Update Cuebot connection settings

Replace localhost with your Cuebot server’s hostname:

{
  "cuebot_host": "cuebot.example.com",
  "cuebot_port": 8443,
  "hostname": null,
  "poll_interval": 5,
  "show_notifications": true,
  "notification_duration": 5,
  "scheduler_enabled": false,
  "schedule": {}
}

Save the file.

3.4 Restart CueNIMBY

cuenimby

Note: We’re not using --verbose this time since we verified it works.

3.5 Verify connection

Right-click the tray icon and select “About”. You should see your hostname and the connection information.

Checkpoint: CueNIMBY is connected to your Cuebot server.

Step 4: Test manual control

4.1 Check current state

Look at the tray icon color:

🟢 Green = Available
🔵 Blue = Working (rendering)
🔴 Red = Disabled
🟠 Orange = NIMBY locked

4.2 Disable rendering

Right-click the CueNIMBY icon
Uncheck “Available”

Observe:

Icon turns red (🔴)
You receive a notification: “Host Disabled”
Title shows “CueNIMBY - Disabled”

4.3 Verify in CueGUI (if available)

If you have CueGUI open:

Go to the Hosts view
Find your workstation
Observe the lock icon indicating the host is locked

4.4 Re-enable rendering

Right-click the CueNIMBY icon
Check “Available”

Observe:

Icon turns green (🟢)
You receive a notification: “Host Enabled”
Title shows “CueNIMBY - Available”

Checkpoint: You can manually control your workstation’s availability.

Step 5: Test job notifications

5.1 Ensure notifications are enabled

Right-click the tray icon and verify “Notifications” is checked.

5.2 Submit a test job

Submit a simple test job to OpenCue that will run on your workstation:

# Example using cuesubmit or cuerun
echo "#!/bin/bash\necho 'Test frame'\nsleep 10" > /tmp/test_job.sh
chmod +x /tmp/test_job.sh

# Submit job (adjust for your environment)
cuerun -s myshow -shot test /tmp/test_job.sh

5.3 Observe notifications

When the job starts on your workstation, you should receive a notification:

OpenCue - Frame Started
Rendering: myshow/test

5.4 Watch state changes

Icon turns blue (🔵) when frame starts
Icon turns green (🟢) when frame completes

Checkpoint: You receive notifications when jobs start on your machine.

Step 6: Configure time-based scheduling

Now let’s set up automatic scheduling to disable rendering during work hours.

6.1 Stop CueNIMBY

Quit CueNIMBY (right-click -> Quit).

6.2 Edit configuration

Open ~/.opencue/cuenimby.json:

{
  "cuebot_host": "cuebot.example.com",
  "cuebot_port": 8443,
  "hostname": null,
  "poll_interval": 5,
  "show_notifications": true,
  "notification_duration": 5,
  "scheduler_enabled": true,
  "schedule": {
    "monday": {
      "start": "09:00",
      "end": "18:00",
      "state": "disabled"
    },
    "tuesday": {
      "start": "09:00",
      "end": "18:00",
      "state": "disabled"
    },
    "wednesday": {
      "start": "09:00",
      "end": "18:00",
      "state": "disabled"
    },
    "thursday": {
      "start": "09:00",
      "end": "18:00",
      "state": "disabled"
    },
    "friday": {
      "start": "09:00",
      "end": "18:00",
      "state": "disabled"
    }
  }
}

This configuration:

Disables rendering Mon-Fri 9am-6pm
Enables rendering 6pm-9am and weekends

6.3 Restart CueNIMBY

cuenimby

6.4 Verify scheduler is active

Right-click the tray icon and verify “Scheduler” is checked.

6.5 Test scheduler behavior

During work hours (9am-6pm):

Icon should be red (🔴)
Manual toggle temporarily overrides, but scheduler resets every minute

Outside work hours:

Icon should be green (🟢) if idle, or blue (🔵) if rendering

Checkpoint: Scheduler automatically controls your workstation based on time.

Step 7: Customize notification behavior

7.1 Adjust notification duration

Edit ~/.opencue/cuenimby.json:

{
  "notification_duration": 10
}

This makes notifications stay visible for 10 seconds instead of 5.

7.2 Test with a job

Submit another test job and observe the longer notification duration.

7.3 Disable notifications temporarily

If notifications become distracting:

Right-click tray icon
Uncheck “Notifications”

State changes still occur, but without desktop alerts.

7.4 Re-enable when needed

Check “Notifications” again to resume alerts.

Checkpoint: You can customize notification behavior.

Step 8: Configure for production use

8.1 Optimize poll interval

For production, you might want to adjust the poll interval based on your needs:

{
  "poll_interval": 10
}

Lower (5): More responsive, slightly higher resource usage
Higher (10-30): Less responsive, lower resource usage

8.2 Set up automatic startup

macOS:

Create ~/Library/LaunchAgents/com.opencue.cuenimby.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.opencue.cuenimby</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/cuenimby</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <false/>
</dict>
</plist>

Load it:

launchctl load ~/Library/LaunchAgents/com.opencue.cuenimby.plist

Linux:

Create ~/.config/autostart/cuenimby.desktop:

[Desktop Entry]
Type=Application
Exec=cuenimby
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true
Name=CueNIMBY
Comment=OpenCue workstation control

Windows:

Press Win+R
Type shell:startup
Create a shortcut to cuenimby in the startup folder

Checkpoint: CueNIMBY starts automatically on login.

Step 9: Integration with RQD

If you have RQD running on your workstation, you can use both together.

9.1 Configure RQD for NIMBY

Ensure RQD is configured with NIMBY enabled (this is usually the default for workstations).

9.2 Test automatic locking

With both RQD and CueNIMBY running:

Start a job on your workstation
Move your mouse or type on keyboard
Observe:
- RQD detects activity and locks the host
- CueNIMBY icon turns orange (🟠)
- You receive “NIMBY Locked” notification
- Running job is killed

9.3 Test automatic unlocking

Stop using keyboard/mouse
Wait 5 minutes (default RQD idle timeout)
Observe:
- RQD detects idle and unlocks
- CueNIMBY icon turns green (🟢)
- You receive “NIMBY Unlocked” notification

9.4 Understand the interaction

RQD: Automatic protection based on activity
CueNIMBY: Visual feedback + manual control + scheduling

Both work together seamlessly!

Checkpoint: RQD and CueNIMBY work together for complete control.

Step 10: Advanced configurations

10.1 Split shift schedule

For users with split shifts:

{
  "schedule": {
    "monday": {
      "start": "09:00",
      "end": "17:00",
      "state": "disabled"
    }
  }
}

Note: Current version supports one period per day. Choose the most important period.

10.2 Lunch hour availability

Enable rendering during lunch:

{
  "schedule": {
    "monday": {
      "start": "12:00",
      "end": "13:00",
      "state": "available"
    }
  }
}

10.3 Remote monitoring

Monitor a different host:

cuenimby --hostname render-node-05

Useful for administrators monitoring multiple machines.

Checkpoint: You understand advanced configuration options.

Troubleshooting

Issue: Icon doesn’t appear

Linux:

sudo apt-get install gir1.2-appindicator3-0.1

macOS/Windows: Check system tray settings and restart CueNIMBY.

Issue: Can’t connect to Cuebot

# Test connection
telnet cuebot.example.com 8443

# Run with verbose logging
cuenimby --verbose

Issue: Notifications not working

macOS:

# Best option: install terminal-notifier
brew install terminal-notifier

# Alternative: install pync
pip install pync

Windows:

pip install win10toast

Linux:

pip install notify2

Summary

Congratulations! You’ve completed the CueNIMBY tutorial. You now know how to:

Install and configure CueNIMBY
Monitor your workstation’s rendering state
Manually control rendering availability
Set up time-based scheduling
Customize notifications
Integrate with RQD for complete NIMBY control

CueNIMBY tutorial

Step-by-step tutorial for configuring and using CueNIMBY

What you’ll learn

Prerequisites

Step 1: Install CueNIMBY

1.1 Verify prerequisites

1.2 Install OpenCue client libraries

1.3 Install CueNIMBY

1.4 Verify installation

Step 2: First run and initial configuration

2.1 Start CueNIMBY

2.2 Observe the output

2.3 Find the tray icon

2.4 Examine the configuration file

Step 3: Configure Cuebot connection

3.1 Stop CueNIMBY

3.2 Edit the configuration

3.3 Update Cuebot connection settings

3.4 Restart CueNIMBY

3.5 Verify connection

Step 4: Test manual control

4.1 Check current state

4.2 Disable rendering

4.3 Verify in CueGUI (if available)

4.4 Re-enable rendering

Step 5: Test job notifications

5.1 Ensure notifications are enabled

5.2 Submit a test job

5.3 Observe notifications

5.4 Watch state changes

Step 6: Configure time-based scheduling

6.1 Stop CueNIMBY

6.2 Edit configuration

6.3 Restart CueNIMBY

6.4 Verify scheduler is active

6.5 Test scheduler behavior

Step 7: Customize notification behavior

7.1 Adjust notification duration

7.2 Test with a job

7.3 Disable notifications temporarily

7.4 Re-enable when needed

Step 8: Configure for production use

8.1 Optimize poll interval

8.2 Set up automatic startup

Step 9: Integration with RQD

9.1 Configure RQD for NIMBY

9.2 Test automatic locking

9.3 Test automatic unlocking

9.4 Understand the interaction

Step 10: Advanced configurations

10.1 Split shift schedule

10.2 Lunch hour availability

10.3 Remote monitoring

Troubleshooting

Issue: Icon doesn’t appear

Issue: Can’t connect to Cuebot

Issue: Notifications not working

Summary

Further reading