`h5pack unpack` documentation

Note

If you're new to h5pack, please consult our Quickstart guide. Please note that this page is just a quick reference to explain different tool options.

This tool converts .h5 files created with h5pack back into their constituent files. Additionally, it automatically generates a configuration .yaml file and an annotations .csv file, enabling you to repack the data using h5pack pack.

Basic usage

h5pack unpack <h5-file>

This will create an output folder with the same name as your .h5 file. Its structure will look as follows:

<output-folder>
├── data
│   └── <field-name>
│       └── <audio-files>
├── dataset.csv
└── h5pack.yaml

Audio files are written to a folder named after their field. If your original audio files were stored in subfolders (e.g. spk1/001.wav and spk2/001.wav), those subfolders are preserved, so files sharing the same name do not overwrite each other. Audio packed with as_audioflac is written as .flac files exactly as it was stored, and audio packed with --skip-filepaths is written using the row index as file name.

Advanced settings

To specify the output folder path, you can use the -o/--output option as follows:

h5pack unpack <h5-file> --output <output-folder>

or using aliases:

h5pack unpack <h5-file> -o <output-folder>

Help

To see all available options, run:

h5pack unpack --help