Public Repository

Last pushed: 2 years ago
Short Description
MAUS forced alignment system for automatic annotation of audio files
Full Description

Docker MAUS

A docker container for MAUS (Munich AUtomatic Segmentation) forced alignment
system. This container makes it easier to run MAUS on non-linux platforms such
as macOS and (probably) Windows. It contains all of the required dependencies
and setup to run MAUS over audio files. All options for the original scripts
are available.

This is a command line container, it has no fixed entry point so you must
give a command line to the 'docker run' command.

MAUS is installed in /home/maus. The following command will run MAUS over the
test file included in the distribution.

docker run -v `pwd`:/export stevecassidy/maus \
    /home/maus/maus OUT=/export/test.TextGrid
    OUTFORMAT=TextGrid \
    SIGNAL=/home/maus/test.wav \

The -v option maps the current working directory on the host machine (your laptop)
to /export in the container. We write the resulting test.TextGrid file out to
that directory so it should appear in the current directory.

(Note that you don't need to install anything other than Docker to run this. The
first time you run the command above, it will download the container; on subsequent
runs it uses the version it has downloaded already.)

To run MAUS over your own files they need to be inside the directory mapped to
/export in the container. For example:

docker run -v `pwd`:/export  stevecassidy/maus \
    /home/maus/maus OUT=/export/test.TextGrid \
    OUTFORMAT=TextGrid \
    SIGNAL=/export/test/1_1119_2_22_001-ch6-speaker16.wav \
    BPF=/export/test/1_1119_2_22_001.bpf \

All of the other scripts in MAUS should work too (maus.corpus, maus.iter etc).

Docker Pull Command