August 15, 2021

Something big has been cooking for a while, and we’re excited that we can finally reveal it to you.

We now have a video editor where you can annotate your video projects with the most accurate detail.

This release also allows you to save queries. So let’s jump right in!

Video project

Create video project

Creating a video project is the same as creating a Pixel or a Vector project. The only difference is in the first step where you need to choose Video with attached URLs as the annotation type. Learn how to create video projects here.

Attach video URLs

You can import videos by linking them from external storages. The linked videos are displayed in SuperAnnotate, but they are not stored in our local servers.

sa.attach_video_urls_to_project(
    project = "Project Name", 
    attachments = "./videos.csv",
    annotation_status = "QualityCheck")
superannotatecli attach-video-urls --project “Project Name/Folder Name” --attachments “./videos.csv” --annotation_status “QualityCheck”

Video editor

Meet the video editor

Once you get to know the basic functionalities, you’ll be ready to make the best of the video editor.

2999
ToolDescription
1Tools panel
2Time spent in the editor per user
3Instances panel (referred to as the right panel throughout the documentation)
4Interpolation toggle
5Status change
6Switch to the previous video
7Switch to the next video
8List of videos in the project
9Disapprove video
10Approve video
11Play/Pause video
12Jump 1 second backward
13Jump 1 second forward
14Video speed
15Jump to X timestamp
16Total duration of the video
17Go to current time
18The green lines shows the current time
19Timeline. Resize it by dragging the slider to change the unit of measurement of the video duration.

Create an instance

You can only annotate using bounding boxes in the video editor.

To create a bounding box, select the bounding box icon in the left panel or press X.

When you create an instance, it will be applied to the frame where you created the instance and onwards.

To limit your instance to a certain frame:

  1. Draw a bounding box. The instance will be interpolated till the end of the video.
  2. Pause the video where you want your instance to end.
  3. In the right panel, turn off the interpolation toggle that corresponds to the instance.

Learn more about annotating in the video editor here.

📘

A white icon appears on the timeline whenever you change the location of an instance. The icon is located at the point in time where you made the change.

Approve/Disapprove video

  • To approve a video, select the thumbs up icon in the bottom panel.
  • To disapprove a video, select the thumbs down icon in the bottom panel.

📘

  • Only Team Admins, Team Owners, Project Admins, and Customers can approve and disapprove videos.
  • Annotators and QAs cannot approve or disapprove videos.
  • You cannot approve or disapprove frames or instances.
  • The status of a video does not change after it is approved or disapproved.

Assign class and attribute

You can assign a class/attribute to an instance in three ways:

Method 1: Right-click on an instance and choose a class/attribute from the drop-down menu.

Method 2: Select an instance and choose a class/attribute from the drop-down menu in the right panel.

Method 3: You can assign a class to an instance before annotating it. Follow these steps:

  1. In the left panel, select the class selection tool.
  2. Choose a class.
  3. Annotate the instance.

The same instance (bounding box) can have multiple attributes.

To assign multiple attributes to the same instance:

  1. Assign an attribute to an instance.
  2. Pause the video where you want to add a new attribute.
  3. Add a new attribute. The new attribute will be interpolated till the end of the video.
  4. Pause the video where you want the new attribute to end. You can choose to add a new attribute or turn off the interpolation toggle.

📘

A white icon appears on the timeline whenever you add a new attribute to an instance. The icon is located at the point in time where you added the attribute.

Queries

Save query

  1. Select the hamburger icon in the input field.
  2. Select Save query.
  3. Enter a query name.
  4. Save.

Edit query

  1. In the top panel, select the bookmark icon.
  2. Hover over the query you want to edit.
  3. Select the edit icon.
  4. Change the name or the query, or both.
  5. Save.

See saved queries list

To see a list of your saved queries, select the bookmark icon in the top panel.

📘

Viewers with the dataset’s public link cannot see save queries.

Delete query

Method 1:

  1. In the top panel, select the bookmark icon.
  2. Hover over the query you want to delete.
  3. Select the delete icon.

Method 2:

  1. In the top panel, select the bookmark icon.
  2. Hover over the query you want to delete.
  3. Select the edit icon.
  4. Delete.

Permissions

Project contributors that have access to the explore feature can view, edit, and delete queries.

What do you think of the updates? We’d love to hear your feedback.

We have a blog. Follow us to stay updated.