Installation¶
Install necessary dependencies:
$ apt-get install ffmpeg
or:
$ brew install ffmpeg
§ You may also need to install HomeBrew.
Install Subaligner via PyPI (pre-emptive NumPy):
$ pip install -U pip && pip install -U setuptools
$ pip install subaligner
Install dependencies for enabling translation:
$ pip install 'subaligner[llm]'
Pre-install additional dependencies before installing subaligner[stretch] or subaligner[dev]:
$ apt-get install espeak libespeak1 libespeak-dev espeak-data
or:
$ brew install espeak
Install dependencies for enabling forced alignment:
$ pip install 'subaligner[stretch]'
Install dependencies for setting up the development environment:
$ pip install 'subaligner[dev]'
Install all supported features:
$ pip install 'subaligner[harmony]'
Install Subaligner via pipx:
$ pipx install subaligner
$ pipx install 'subaligner[stretch]'
$ pipx install 'subaligner[dev]'
Install from GitHub via Pipenv:
$ pipenv install subaligner
$ pipenv install 'subaligner[stretch]'
$ pipenv install 'subaligner[dev]'
Container Support:
$ docker run -v `pwd`:`pwd` -w `pwd` -it baxtree/subaligner bash
Users may prefer using a containerised environment over installing everything locally. The following builds are available on dockerhub for several Linux distributions: CentOS 7 (latest and VERSION.el7), CentOS 8 (VERSION.el8), Ubuntu 18 (VERSION.u18), Ubuntu 20 (VERSION.u20), Debian 10 (VERSION.deb10), Fedora 31 (VERSION.fed31) and ArchLinux (VERSION.arch).
You can also download the latest release on GitHub and follow the steps down below to create a virtual environment and set up all the dependencies:
Install Subaligner from source:
$ git clone git@github.com:baxtree/subaligner.git && cd subaligner
$ pip install -U pip && pip install -U setuptools
$ python setup.py install
Subaligner CLI should be on your PATH now:
(.venv) $ subaligner --help
(.venv) $ subaligner_1pass --help # shortcut for "subaligner -m single"
(.venv) $ subaligner_2pass --help # shortcut for "subaligner -m dual"
(.venv) $ subaligner_batch --help
(.venv) $ subaligner_convert --help
(.venv) $ subaligner_train --help
(.venv) $ subaligner_tune --help
On Windows:
docker pull baxtree/subaligner
docker run -v "/d/media":/media -w "/media" -it baxtree/subaligner bash
Assuming that your media assets are stored under “d:\media”, open built-in command prompt, PowerShell, or Windows Terminal and run the above. Docker Desktop is the only option at present for Windows users.