Installing CueAdmin

Install the CueAdmin command-line client

CueAdmin is the OpenCue command-line client.

You run this client to administer an OpenCue deployment. It’s written in Python and provides a thin layer over the OpenCue Python API.

Before you begin

Before you start to work through this guide, complete the steps in Installing PyCue and PyOutline.

You need the same Cuebot hostname that you used to configure PyCue in this guide as well. If you don’t know the Cuebot hostname, check with your OpenCue admin.

To follow the instructions in this guide, you’ll need the following software:

Installing CueAdmin

CueAdmin is written in Python. To run CueAdmin, you install a series of dependencies and configure a virtual environment for the Python code to run inside.

  1. To install the required Python packages, create an isolated Python environment:

    virtualenv venv
  2. Evaluate the commands in the activate file in your current shell:

    TIP: To review the contents of the activate file, run cat activate.

    source venv/bin/activate

Option 1: Installing a published release

Visit the OpenCue releases page and download the cueadmin tarball from the latest release’s Assets.

export CUEADMIN_TAR="<path to cueadmin tar.gz>"
export CUEADMIN_DIR=$(basename "$CUEADMIN_TAR" .tar.gz)
tar xvzf "$CUEADMIN_TAR"
cd "$CUEADMIN_DIR"
pip install -r requirements.txt
python setup.py install
cd ..

This installs a cueadmin executable in your PATH.

To run cueadmin:

cueadmin -server localhost -ls

The above example command lists all shows from a Cuebot instance running on localhost. To display a full list of the functionality CueAdmin provides, run cueadmin --help .

Option 2: Installing from source

Make sure you’ve checked out the source code and your current directory is the root of the checked out source.

pip install -r requirements.txt
cd cueadmin

You can either install CueAdmin from here and run the cueadmin executable that gets created:

python setup.py install
cd ..
cueadmin -server localhost -ls

OR you can run the software directly, without installing:

python ./cueadmin -server localhost -ls

The above example command lists all shows from a Cuebot instance running on localhost. To display a full list of the functionality CueAdmin provides, run cueadmin --help.

Last modified Tuesday, July 9, 2019: Add create project issue link (4d14b47)