Skip to main content

TXT URL lists

TXT URL lists are the simplest way to create a self-hosted dataset. Upload a .txt file where each line is the public URL of one remote stimulus.

https://cdn.example.com/datasets/source_1/model_a.wav
https://cdn.example.com/datasets/source_1/model_b.wav
https://cdn.example.com/datasets/source_2/model_a.wav
https://cdn.example.com/datasets/source_2/model_b.wav

How groups are created​

Mabyduck uses the URL path to infer the stimulus group and stimulus name:

  • The parent folder becomes the stimulus group.
  • The final path segment becomes the stimulus name.

For example:

https://cdn.example.com/datasets/source_1/model_a.wav

Creates:

  • Group: source_1
  • Stimulus: model_a.wav

If the URL does not include a parent folder, the stimulus is placed in a group named root.

When to use TXT URL lists​

Use a TXT URL list when:

  • Your files are already hosted somewhere public.
  • The URL paths already contain useful group names.
  • You do not need to rename conditions separately from the remote filenames.

If you need explicit group names, condition names, or file extensions that are not present in the URL, use a CSV manifest instead.

Requirements​

Each line must contain one valid public URL. Do not include blank lines. In normal use, URLs should start with https://.

Localhost and private network URLs will not work.