These installation instructions assume you already have Python installed. If you do not already have a copy of Python, we recommend you install Anaconda Python.


autoscrub’s Python 3 support is experimental, and only works with 3.4+. If you run into any troubles with Python 3, please let us know via the issue tracker, and then try Python 2.7 instead.


Autoscrub requires that you have FFmpeg installed in your system, and that it is accessible from the directory autoscrub is run in (usually by appending the location of the FFmpeg executables to the system PATH).


FFmpeg can usually be installed via your linux package manager. This typically also ensures that the location of FFmpeg is added to the system PATH.


Windows binaries can be downloaded here. We recommend using the stable version (the one with a 3 digit version number). You will need to select the version that matches your system architecture (usually 64-bit) and with static linking. We have tested with FFmpeg v3.3.3 (x64-static) but any newer version should also work.

autoscrub requires the ffmpeg.exe and ffprobe.exe files be accessible from the directory that autoscrub is run from. You can either place the executables in a common location and add that location to the windows PATH environment variable or place the executables in the folder you will run autoscrub from (for example the folder containing your media files you wish to convert).


FFmpeg builds can be found here.



We recommend installing autoscrub from the Python Package Index. To do this, open a terminal (linux/OSX) or command prompt (Windows) window, and run:

pip install autoscrub

Upgrading autoscrub

To upgrade to the latest version of autoscrub, run:

pip install -U autoscrub

To upgrade to a specific version of autoscrub (or, alternatively, if you wish to downgrade), run:

pip install -U autoscrub==<version>

where <version> is replaced by the version you wish (for example pip install -U autoscrub==0.1.3).

Development Version

If you wish to use the latest development version, you can obtain the source code from our mercurial repository. Once you have cloned our repository, you should run python install in order to build and install the autoscrub package.