Importing Media Files from Tab Delimited Text File

It is possible to import a large amount of media files from a tab-delimited (also known as tab-separated) text file. Tab-delimited text files (.txt or .tsv extensions) can be generated by Microsoft Excel or other spreadsheet applications.

The tab-delimited file can define the following elements:

WAV or MIDI file to import.
Object structure to contain the files.
Any property values or references, such as the Voice Volume or Output Bus.
Events to create.

The first row of the tab delimited text file defines the content of the columns for the subsequent rows. The order of the columns has no impact on the import process.

Possible column headers are:

Header

Content

Audio File

Defines the path to the WAV or MIDI file to import. The file will be copied to the Originals folder if it's not already present in it.

The path can be absolute or relative to the tab- delimited file's directory.

Example: C:\MyWaves\MyFolder\MySound.wav

This column can be left blank if creating a container.

If the column Object Type is not defined, the Audio File column defines the name of the imported object.

Object Path

Defines the path and name of the object to be created. The path used backslashes. The path can either be absolute or relative.

Absolute: full path, starting by a backslash and the object category.

Example: \Actor-Mixer Hierarchy\MyWorkUnit\MyVirtualFolder\MySound
Relative: path relative to the import destination, specified in the Audio File Importer dialog.

Example: MyVirtualFolder\MySound

If this column is left blank, the name of the object will be taken from the imported audio file, and will be imported to the destination specified in the Audio File Importer dialog.

Object Type

Specifies the type of the object.

Common object types:

Virtual Folder
Actor-Mixer
Switch Container
Random Container
Sequence Container
Blend Container
Sound SFX
Sound Voice
Audio Source
Music Switch Container
Music Playlist Container
Music Segment
Music Track

If this column is left blank, a default object type will be selected depending on the destination.

Work Units can not be created at import.

	Note
	It is not possible to create Actor-Mixer Hierarchy objects and Interactive Music Hierarchy objects during the same import.

	Note
	It is not possible to create Sound SFX objects and Sound Voice objects during the same import.

Property[PropertyName]

Example:

Property[Voice Volume]

The column header specifies which property to set. The property name is the display name, as shown in WObjects.xml, RTPC tab, Multi-Editor or List View.

Common property names:

Voice Volume
Voice Pitch
Voice Low-pass Filter
Voice High-pass Filter

Each subsequent row specifies a property value to set on the created objects.

Enumerated values must specify the integer value associated with the enumerated name, which can be found in the .wwu files or in WObjects.xml.

If this column is left blank, no value is set.

Reference[ReferenceName]

Example:

Reference[Output Bus]

The column header specifies which reference to set. The reference name is the full display name, as shown in WObjects.xml.

Common reference names:

Output Bus
User Auxiliary Send 0
User Auxiliary Send 1
User Auxiliary Send 2
User Auxiliary Send 3
Conversion Settings
Effect 0
Effect 1
Effect 2
Effect 3
Attenuation
Motion Bus
MIDI Target

Each subsequent row specifies one of the following:

Absolute Path: Absolute path to object in the project.

Example: \Master-Mixer Hierarchy\Default Work Unit\Master Audio Bus\Sub Bus
GUID: The GUID to the object, which can be found in .wwu files.

Example:{8648567E-97C2-4e81-8853-DA0B32C463E4}

	Tip
	To obtain the absolute path or the GUID to an object, hold the Shift key and right-click the object to show the shortcut menu. Select Copy path(s) to clipboard or Copy GUID(s) to clipboard.

If this column is left blank, no reference is set.

Notes

Defines the notes or comments for the object to be created.

Event

Defines the name of an event to be created for the imported object.

This column can contains one the following:

Absolute path: Absolute path to an event, which starts with \Events\, followed by the work unit name.

Example: \Events\MyWorkUnit\PlayEvent
Relative path: Relative path to the Default Work Unit for the events.

Example: MyVirtualFolder\PlayEvent

To specify the action type, append @ActionName to the end of the event name. If not specified, the Play action will be used.

Examples:

MyEvent@Play
MyEvent@Stop
MyEvent@Pause
MyEvent@Resume
MyEvent@Break
MyEvent@Seek

A Virtual Folder will be created for any path element that does not already exist at destination.

If the specified event already exist at the destination, a new event action will be appended to the existing event.

	Tip
	To create multiple events for a single object, you can add the Event columns multiple times.

Here is an example of a tab delimited worksheet that creates a random container called 'Bird' with 3 sounds.

Audio File	Object Path	Property[Voice Volume]	Reference[Output Bus]	Event
	Bird		\Master-Mixer Hierarchy\Default Work Unit\Master Audio Bus\Music	Play_Bird
C:\Sound1.wav	Bird\Sound1	-3
C:\Sound2.wav	Bird\Sound2	-4
C:\Sound3.wav	Bird\Sound3	-2

To import a tab delimited file

In Project Explorer, select the import destination object.
Right-click the object to open the shortcut menu.
From shortcut menu, select Import Audio Files... (Shift+I).
Click the Import Tab Delimited... button.
Browse for the tab delimited file, and click OK.
Verify the import content in the Audio File Importer list.
Click Import.

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Get started with Wwise

Wwise Help