Nuxeo Connector

Updated: July 8, 2022

The Nuxeo connector allows users to improve their capabilities of syncing and collaborating on content from/to Adobe Premiere, and other video editing tools, through

It enables you to store master files in Nuxeo, but collaborate on lower resolution proxies through You can therefore do all the review work in and once you are finished, send your finished video back to Nuxeo. It will import the Master file along with its metadata, comments and annotations.

This page will help you to:

  • Configure the account.
  • Deploy and configure the add-on for Nuxeo.
  • Test the add-on.

Installation Setup


  1. You first need to register a Frame IO account or connect to your account.
  2. Create a team/verify that all users within your team have the correct access permissions.
  3. Create a new project and upload some assets.


Create an OAuth 2 Application

A user with administrator priveleges on the account needs to create the Oauth 2 application.
For this you can:

  1. Click on your at the top left, and click on Apps & Integration.
  2. From the left menu, select the Apps link in the Developer category.


In case of blank page:

  1. Login to the developer site at
  2. Navigate to
  3. Click the Create an OAuth app button.
  4. Fill in the form:

It should look like this in the end:


You'll want save the Client Id and Client Secret because we will need them at a later stage.

Nuxeo Side


Your Nuxeo instance must be live.
As an example:

The URL should match the previously created OAuth 2 app redirect URL on the Frame IO side!

Addon Deployment

  1. Stop your nuxeo instance:
    /opt/nuxeo/bin/nuxeoctl stop
  2. Install the <> Nuxeo add-on as you would any other:
    /opt/nuxeo/bin/nuxeoctl mp-install nuxeo-frameio
  3. Start your Nuxeo instance:
    /opt/nuxeo/bin/nuxeoctl start

Register the provider

Only an administrator user is able to register the provider. You only need to do this once to enable folder-binding functionality for your team.

  1. Log into the Nuxeo UI with Administrative privileges.
  2. From the left menu, go to Administration, then Cloud Services.
  3. Add a new provider.

The following form will be pre-filled for you, you only need to add the Client ID and Client Secret, enable the provider and enable the service.

Fill the form:

  • Service name: frameio
  • Description: Provider
  • Client ID: paste from Oauth 2 application
  • Client Secret: paste from Oauth 2 application
  • Authorization Server URL:
  • Token Server URL:
  • User Authorization URL:
  • Scopes: action.create,action.delete,,,action.update,,,,offline


Your team will now be ready to bind folders with their projects.

Use Case


The user must have:

  • A account
  • Access priveles to the project
  • A Nuxeo account

Step 1: Bind a Nuxeo folder with a project.

  1. Login to Nuxeo.
  2. Create a new Folder or go to an existing one.
  3. From the summary view, click the Bind to option, available on the action menu.
  4. A pop-up is displayed.
    You can name the Custom Action that will appear on the side to push assets to your Nuxeo repository. You can call it Publish to Nuxeo for example.
    If you want to bind another folder, another Custom Action will be created and you will need to name it differently.
  5. Fill the form and click the Validate button.
  6. Take a look at the new tab named Frame IO.
    You can now see that your folder is bound with the team we selected earlier.

Step 2: Push an asset from to Nuxeo

  1. Login to
  2. Navigate to the shared project.
  3. Select a file and push the file to Nuxeo using the custom action.
  4. After a few seconds, the popup displays "Asset pushed to Nuxeo”.
    It means that the video is being sent to Nuxeo and is currently being uploaded into your Nuxeo folder. You will receive an email notification when your video is available in your Nuxeo folder.

Step 3: Check the new created document into Nuxeo

From the summary view of the bound folder, check the new created document.


You are now able to retrieve your video and read the metadata imported from in the document tab.

Note that, if you are sending a new version of the video from, we will then increment the version in Nuxeo following your rules.


Optional: UnBind a Nuxeo Folder with a project.


At any given moment, you are able to unbid your folder with your project.
This will have immediate effect and your team members won’t be able to send new content to your Nuxeo folder.

Everything that was previously pushed to your Nuxeo folder will stay in your folder.

We'd love to hear your thoughts!

All fields required