Audio Labeling Editor

Overview of the Audio Labeling Editor in Ango Hub

Ango Hub provides a labeling editor with which audio files can be annotated.

This article will exclusively go over Ango Hub’s audio labeling interface. Features common to all labeling editors (audio, image, PDF, and text) are instead explained here.

Overview of the Audio Labeling Editor in Ango Hub

Audio Interface Elements

Playback bar

allow you to move the playhead to the beginning of the audio file, five seconds back, play/pause, five second forward, and to the end of the file.
The button becomes active when a segment is selected, and allows you to start playback starting from the beginning of the selected segment. (Pressing R on your keyboard will also enable this.)
indicates the position of the playhead / the total duration of the audio file.
When a segment is selected, allow you to move to the next/previous segment.
If Auto Scroll is enabled, the list of segments below the playback bar will move with the playhead, always displaying as selected the currently playing segmentation.
If Loop is enabled, playback will repeat. If you are listening to a single segment (using R), the segment will repeat. Otherwise, the entire audio will repeat. (Pressing L on your keyboard will also enable this.)
The icon enables you to pick a playback speed.
The zoom slider enables you to pick a zoom level. You may also zoom in/out with the scroll wheel. Both types of zoom always zoom towards the current location of the playhead.
The volume slider allows you to change the playback volume.

Top Bar

Click on the "Model Plugins" button to open a list of model-type plugins available in your organization.

If a default preset has been set for the plugin, the button will be clickable, and clicking on it once will run the plugin on the current asset with the default settings.

Clicking on the three dots next to the model name will open the Model Run Dialog, allowing you to customize the plugin's run settings and to run the plugin on the current asset with settings of your choice.

Segment List

The Segment List allows you to see, at a glance, each segment currently present in the audio file. If segments have nested classifications, those classifications will be displayed in the segment list. This can, for example, be a text classification, a dropdown, radio, or any other available classification type.

Clicking on the three dots next to each class's name will open a menu where you can open object-specific issues, or copy the unique Object ID of that object.

The id column displays a unique ID for the segment. These are the first three characters of the Object ID.

The Classifications column displays nested classifications of the class belonging to the segment, if any.

The Start and End columns display the timestamp when the segment starts and ends in the audio file. The Duration displays the duration of the segment.

You may additionally delete the segment by clicking on the trash can.

How to Annotate Audio

From the playback buttons on the bottom bar, start and stop playback of the audio file as necessary.

If you get no sound, make sure that:

Your system volume is on
The volume slider on the bottom bar is not all the way to the left
You have selected the right output device on your computer

From the Tools section on the left sidebar, select an Entity labeling tool, marked with an underlined A icon.

Click on the waveform where you’d like the annotation to start. Keep the left mouse button pressed and drag until where you’d like the annotation to end. Release the left mouse button.

You can change the start and end points of the annotation by selecting it with left-click, then dragging on one of the ends. You can drag the entire annotation by, after selecting it, clicking and dragging from the middle of the label.

If the labeling tool has nested questions, right-click on the label and click on the menu that appears to see and answer the nested questions.

If classification questions are present, you may answer them from the Questions panel on the left sidebar.

Opening Spot Issues

Besides issues about the asset as a whole and about individual objects, as outlined in the docs page on issues, in audio assets you may also open 'spot' issues about specific timestamps or ranges of timestamps.

To do so, click on the issue bubble icon at the top-right of the screen. Then, either click once on the audio where you would like to open the issue, or click and drag on the audio waveform over the section of audio related to the issue: