/ HALion Developer Resource / HALion Tutorials & Guidelines / Guidelines /

MediaBay Guideline


On this page:


With the help of MediaBay attributes, you can quickly and easily browse and search presets. Attributes are descriptive keywords that you can assign to your presets. Good search results in the MediaBay highly depend on accurately set attributes. When you specify attributes for your final HALion Sonic program presets, you should follow the guideline below. This ensures an equal quality of the attributes and, therefore, improves browsing and searching in the MediaBay.

❕ Please use the MediaBay of HALion Sonic to specify attributes for your presets. Do not use the MediaBay of Cubase, because it contains attributes that are not supported by HAlion Sonic presets.

Library Creator Properties

The following attributes are assigned automatically to all your presets when you build your libraries using the Library Creator:

Library Creator PropertyMediaBay AttributeDescription
Long NameLibrary NameIf the Long Name is too long, the Name property is used instead.
ManufacturerLibrary ManufacturerYour name or company name.
FamilyPlugIn NameThe target plug-in that the library was designed for.

Any other attributes must be set manually.

Which Media Files Must Get Attributes?

  • The MediaBay scans only those VST3 presets that are located in the VST3 Presets folder of your library. This means that you must specify attributes for all VST3 presets that are located in this folder. Otherwise, the users cannot find the presets. In the Library Creator, a warning message is displayed if attributes were not set.
  • The subpresets in the VST3 Sub Presets folder are not scanned by the MediaBay and do not need attributes. These subpresets are loaded via a script and not with the MediaBay.
  • All samples of your library are located in a Private Audio folder. Private means that the MediaBay does not scan these samples and you do not need to add attributes to them. The samples are loaded together with the VST3 preset or via a script.

Library Creator Structure

VST3 Preset Attribute Conventions

The different preset categories require different sets of attributes. This guideline gives you advice on how to add the correct attributes.

  • For regular instrument presets, the common attributes should be set.
  • For categories like Drum&Perc > Beats, for example, you should add additional attributes.

Common Attributes

The following MediaBay attributes must be set for each preset manually:

MediaBay AttributeDescription
AuthorThe name of the company or of the sound designer.
Category/Sub CategoryUse this attribute to classify the sound. If you set the Sub Category first, the Category is set automatically.
PropertiesSee Properties, Moods and Articulations.
MoodsSee Properties, Moods and Articulations.
ArticulationsSee Properties, Moods and Articulations.
RatingA rating of three stars is recommended as starting point for presets. The users can then lower or raise the rating.
NameThis attribute is defined with the preset file name when the preset is saved.

The following MediaBay attributes are set automatically by the Library Creator. You must set the corresponding properties in the Library Creator before you build the library.

MediaBay AttributeDescription
Library ManufacturerThis attribute is defined with the Manufacturer property in the Library Creator.
Library NameThis attribute is defined with the Long Name property in the Library Creator.
PlugIn NameThis attribute is defined with the Family property in the Library Creator.

Properties, Moods and Articulations

Properties, Moods and Articulations describe the character of a sound with labels. As soon as you type, you get a suggestion of labels. You can select a suggested label to autocomplete it. This also helps to avoid spelling mistakes. You should at least set some Properties that describe the sound as you hear it. Moods and Articulations are optional. The difference between Properties and Moods is that the Properties describe a sound acoustically without rating it. The Moods describe a sound emotionally and therefore interpret and rate it. Articulations describe the way the sound or instrument is played, as a composer would describe it.

The libraries of FM Lab and Tales both use Properties. FM Lab even uses Articulations on some presets. You can use these two libraries as examples for your own productions.

FM Lab MediaBay

  • Set the Properties, Moods and Articulations so that they describe the preset as precisely as possible.
  • Labels that do not match what you hear should be avoided.
  • Fewer labels that perfectly match are much better than too many labels that only partially match.
  • Use the autocomplete feature to avoid spelling mistakes.

❕ Presets that use an arpeggiator should not get the Category Synth Lead > Arpeggio by default. You should use this Category only for classic arpeggio sounds. If you have a synth bass with a step sequencer or arpeggio, you should set the Category Bass > Synth Bass. To indicate that the preset contains an arpeggio or a sequence, set Arpeggio or Sequenced as label for the Properties, instead.

Additional Attributes

These attributes can be set in addition, e.g., for VST3 presets with the Category Drum&Perc > Beats.

MediaBay AttributeDescription
SignatureThe time signature as numerator and denominator.
StyleUse this attribute to classify the musical style. If you set the Sub Style first, the Style is set automatically.
Sub StyleUse this attribute to classify the musical style. If you set the Sub Style before the Style, the Style is set automatically.
TempoThe tempo in beats per minute (bpm).

Special Attributes

These attributes are mainly needed to display information in HALion's Browser.

MediaBay AttributeDescription
Bars & BeatsThe number of bars and beats in a loop, for example. This attribute is set for samples, not for presets.
CommentUse this attribute to add a comment to each preset.
Family NameThis attribute is used for sample sets. Samples with the same Family Name belong to the same sample set.
Follow TempoThis attribute defines whether a loop uses AudioWarp to follow the host tempo.
GM SoundThis attribute defines the program number of a GM Sound.
KeyThe key in which a loop was written, for example, a loop with chords or a loop with a melody.
KeywordsThis attribute is set by HALion when you import third-party sampler programs.