# Label Tracks

From Audacity Development Manual
A Label Track is an additional track that can be created in your project. The labels in the label track can be used to reference points or regions in the project's audio tracks but the label track itself does not contain audio.

## Contents

- Features of a Label Track
- Point labels and region labels
- Using the Label's context menu
- Creating and selecting Labels
- Navigating Labels
- Editing, resizing and moving Labels
- Removing Labels only
- Removing Labels together with their associated audio
- Label Editor
- Editing or moving the Label Track using the Label Track Dropdown Menu
- Collapsing the Label Track
- Selecting the Label track
- Importing and Exporting Labels
- Track focus

## Features of a Label Track

- Labels can be used to mark then restore chosen points or regions of audio for playback or editing.
- Labels can contain text for purposes of annotation or transcription.
- Labels and their text provide a convenient way to name different songs in a recorded track then export all songs at once to separate audio files using the Multiple Files option in Export Audio.
- Many of the tools in the Analyze Menu use labels to mark detected regions (such as regions of silence, sound or clipping). Point labels can mark detected beats.
- The label text can be edited and you can resize region labels or move region or point labels.
- The Label Track's Dropdown Menu can be used to name the track, move it up or down or set the font of all label text.
- Label tracks are included when saving an Audacity Project.
- Label tracks can be used to define sets of Sync-Locked Track Groups.

| Standard Edit Menu commands can be applied to the audio of multiple labeled regions (excluding audio outside those regions). To do this, drag a selection in the Label Track that fully includes (or extends beyond) the labels whose audio is to be affected, then choose Edit > Labels > Label Editor and your required command.

### Limitations of Labels

- The text in a label should be less than 260 characters. Although more than 260 characters may be entered, if the project is saved, the label will not be loaded when the project is reopened.
- If there a very large number of labels in a project (hundreds or thousands), Audacity may become noticeably sluggish.
- There is no simple way to convert a "region label" into a "point label". The easiest way is to delete the region label and add a new point label.
- (Microsoft Windows) Labels do not support IME input. To enter Chinese / Japanese characters into a label, use copy and paste.

## Point labels and region labels

Audacity supports labeling points, a single moment in the audio, and labeling regions, a span with a start and end time.

- A point label is just a region label with the same start and end.
- If you have several region labels one after the other, and each one starts where the previous one ends, they join together. You can then adjust the end of one label and the start of the next at the same time.

    Example of a mono audio track with a label track containing a region label and a point label.

## Using the context menu

Right-clicking a label will cause its context menu to appear:

From this menu you can:

- Cut or Copy any text selected in the label to the system clipboard
- Paste any text that is currently on the system clipboard
- Delete the label
- Open Label Editor to edit only that label's Start Time and End Time (and also its Low Frequency and High Frequency for use in Spectral Selection).

## Creating and selecting Labels

Labels can be created by selecting a region or clicking at a point of interest then choosing Edit > Labels > Add Label at Selection (or use its keyboard shortcut Ctrl + B). An empty label appears then you can type to add text to the label. Press Enter on the keyboard to confirm the text and close the label.

If you turn on Typing Creates New Labels in Tracks Behaviors preferences (it is "off" by default), then when a label track has the colored focus border as in the image above (the actual color depends on the Theme you choose) you can create a label at the cursor position or selection just by typing the label text.

You can also create labels while playing or recording.

- To create a point label at the current position of the green playback cursor or red recording cursor, choose Edit > Labels > Add Label at Playback Position or its keyboard shortcut Ctrl + M (⌘ + . on Mac).
- To create a region label while playing or recording, click and drag the region then use the same Add Label at Selection command (or its shortcut Ctrl + B ) as when adding a region label when the track is stopped. Similarly you can click anywhere in a track while playing or recording and use Ctrl + B to label that point.

You can create extra label tracks using Tracks > Add New > Label Track but when exporting multiple files based on labels, audio is only exported for the labels in the uppermost label track in the project.

### Selecting a Label

When you click inside a label to select it, the label background color changes to white, indicating that the label text is open for editing, and the cursor point or region of audio the label corresponds to is restored. The region will be visible in all audio tracks that are selected and the cursor will be visible in all audio tracks that had the colored focus border (the actual color depends on the Theme you choose). This applies even if the label track is above the audio track.

See this page for more details on label creation and selection.

## Navigating Labels

### Open label for editing

When focus is on a label track as indicated by the colored focus border (the actual color depends on the Theme you choose):

- TAB opens the next label for editing and places the editing cursor or selection to correspond with that label
- Shift + TAB opens the previous label for editing and places the editing cursor or selection to correspond with that label.

The label background becomes white, indicating you can type to edit the label's text. For a point label, the editing cursor is placed at the label moved to. For a region label, a selection is placed corresponding to the label moved to. The view position moves if necessary to show you the label moved to.

Audacity cycles through the labels automatically, so when at the last label, moving to next label jumps to the first label. When at the first label, moving to previous label jumps to the last label.

These commands exist only as shortcuts - they have no menu items or buttons.

### Just move to the label

There are also two shortcut commands to move between labels without opening them for editing. These shortcuts do not require the colored focus border to be in a label track:

- Alt + Right places the editing cursor or selection to correspond with the next label
- Alt + Left places the editing cursor or selection to correspond with the previous label.

The view position moves if necessary to show you the label moved to, centered in the view.

If there is a single label track, you do not need to be aware of which track has the colored focus border.

If you have multiple label tracks, use Up or Down arrow to move the colored focus border into the label track you wish to use. If there is more than one label track and none have focus, then the first label track downwards from the focused audio track is used.

During playback these "Move to the label" commands restart playback at the position of the label moved to. This is useful if you have a long recording which you want to split into separate tracks using labels.

As with the TAB and Shift + TAB commands, Audacity cycles through the labels automatically, and there are no corresponding menu items or buttons.

## Editing, resizing and moving Labels

You can edit labels by changing their text content, resize region labels or move region or point labels.

You can change label positions:

- move a point label by clicking and dragging its circle handle. Be very careful when moving a point label not to accidentally click on a chevron and thus create a region label
  - You can also move a point label by holding the Shift key down while clicking and dragging the circle or either of its chevron handles.
- expand a point label into a region label by clicking and dragging either of its chevron handles
- move a region label by clicking and dragging the central line, the drag-bar.
  - You can also hold the Shift key while clicking and dragging its circle or either of its chevron handles.
- change the length of a region label by clicking and dragging either of its chevron handles or its circle handle
- adjust the junction point where two labels meet by clicking and dragging their shared circle handle
- if you remove part of a label track inside a region label this will reduce the duration of the region label.

You can cut and paste region labels using Edit > Cut and Edit > Paste, but you have to make sure you do not select any audio, or you will end up cutting and pasting audio where you probably did not intend.

See Editing, resizing and moving Labels for more details on editing labels.

## Removing Labels only

Labels can be removed (deleted) in a number of ways. However because labels are usually associated with an audio track, the label deletion method may affect whether or not the remaining labels are still synchronized with the audio (that is, remain associated with the same part of the audio track). Incorrect edits to label tracks can always be undone by using Edit > Undo.

- Delete Label - retains audio synchronization:

  Right-click inside the label's text box and choose Delete Label from the dropdown menu. Any labels lying to right of the removed labels stay where they are, still associated with their original audio.

- Split method - retains audio synchronization:

  Often you may want to remove labels from the label track without removing their associated audio, while keeping the remaining labels synchronized with their audio.The quickest way to do this is to select any region in the label track that extends beyond the label or labels to be removed (without reaching other labels), then choose Edit > Remove Special > Split Delete, or its shortcut Ctrl + Alt + K. Any labels lying to right of the removed labels stay where they are, still associated with their original audio.

- Label text removal method - retains audio synchronization:

  You can use this method to remove a single label. Open the label, remove the text then press Backspace or Delete once to remove the empty label. All remaining labels remain synchronized with their audio.

- Delete method - loses audio synchronization for labels to right of the delete point:

  To remove labels or a region of label track so that the following labels move back (leftwards), select over or between labels then choose Edit > Delete, or its shortcut Ctrl + K. Labels following to right of the removed labels will always move backwards (earlier on the Timeline) according to the length of the removed selection.

See Removing Labels - Examples for examples of the various methods.

### Deleting the entire Label Track

You can also remove all labels at once by deleting the label track entirely. To remove the entire label track and all its labels, click in the label track and choose Tracks > Remove Tracks. Alternatively, click the close button in the upper-left corner of the label track.

Label tracks can be exported as a text file and are required for splitting a long recording to separate files using Export Multiple. However labels themselves cannot be included as part of an exported audio file so there is no need to remove additional label tracks that for example were used for annotation or transcription but are no longer required.

## Removing labels together with their associated audio

In most cases when you remove parts of the label track, you will also want to remove the corresponding audio so that the remaining labels are still synchronized with their original audio, for example, you may have labeled a region of noisy audio for later deletion.

To remove the audio region as well as the label region, select over or between the labels as required then include the audio track in the selection by dragging the selection upwards to include the audio track, then choose Edit > Delete or its shortcut Ctrl + K. Similarly, if you want to keep labels and audio synchronized when deleting audio to left of a label, you must include the label track in the selection before deleting.

Keyboard use: To include the audio track in the label selection, or vice versa, press Up or Down as appropriate then Enter. See Selecting using the keyboard.

| Alternatively you can enable Tracks > Sync-Lock Tracks. This feature defines groups of Sync-Locked audio and/or label tracks, such that a length-changing action in one track of the group affects all the others in the group, even if they are not all selected.

A convenient way to select and delete the exact area of an individual region label together with its corresponding audio (moving the following audio backwards) is to click in the label, then press Enter followed by Delete or Backspace. If your Interface Preferences are set to "Retain labels if selection snaps to a label edge", this retains a point label at the former left-hand edge of the region.

Keyboard use: Use Up or Down then Enter if needed to select the audio track, then repeat as needed to also select the label track. Then Tab into the label to be removed, press Enter then Delete or Backspace.

See here for an example of removing labels with their associated audio.

## Label Editor

Edit > Labels > Label Editor launches a keyboard-accessible Label Editor where you can perform all remove, text edit, resize and move operations on labels. All the labels and label tracks in the project are displayed in a tabular view, similar to a spreadsheet. Each row represents a single individual label.

See Label Editor for more details on the editor.

## Editing or moving the label track using the Label Track Dropdown Menu

Clicking the label track's name by the downward-pointing triangle or right-clicking in the label track's Track Control Panel (or using shortcut Shift + M or the keyboard Menu key when the label track has focus) opens the Label Track Dropdown Menu:

- Rename Track

  Displays the "Track Name" dialog where you can give the track a new name. Useful in multi-track projects to provide a visual indication of the content of each track.

- Font

  Displays the "Label Track Font" dialog where you can set the font and font size of the labels. Note that this is a global setting and applies to all all label tracks in all projects.

| The Font setting for label tracks is not reset by the use of Reset Configuration.

### Moving Tracks

Tracks can be moved up and down using the menu items.

- Move Track Up: Moves track up.
- Move Track Down: Moves track down.
- Move Track to Top: Moves track to become the topmost track in the project.
- Move Track to Bottom: Moves track to become the bottom track in the project.

Label tracks can also be moved up or down by clicking between the controls in the track's Track Control Panel then dragging upwards or downwards.

## Collapsing the Label Track

Track Collapse chevron:

Click on this, at the top of the Track Control Panel, to make the track 'fold up' into a smaller size. Click again, or drag the lower edge of the track to restore the size.

## Selecting the Label Track

Just double-click in the Label track, or single-click in the Track Control Panel, to select all the labels in the track.

## Importing and Exporting Labels

Label Tracks can be exported to, and imported from plain text files ( .txt extension in Windows). The file structure is a tab-delimited plain text format that can be opened by any text editor or spreadsheet application and edited there.

See this page for more details on text label files.

## Track focus

You may have noticed in the images on this page that some of the tracks have a colored border around them (the actual color depends on the Theme you choose). This border indicates that this track has focus.

The track that has focus is the track that accepts any command whose name includes "focused track". These commands include commands such as "Close focused track" (Shift + C), "Mute/Unmute focused track" (Shift + U) and "Toggle focused track" (RETURN or Enter, which toggles whether the focused track is selected or not).

The complete list of "focused track" commands can be seen by searching for "focused track" (without quotes) in Keyboard Preferences or by viewing the description of these commands in Keyboard Shortcut Reference.

| Note carefully that a track having focus does not necessarily mean that the current selection is in that track. It is quite possible to have a selection in one track and for another track to have the focus.

## Links

> Track Control Panel and Vertical Scale

> Note Tracks (MIDI)

|< Audio Tracks