Installation

pysoundanalyser has been successfully installed and used on Linux, Windows, and Mac platforms. Installation instructions for each operating system are provided below.

Installation on Linux

For Debian and Ubuntu LTS releases there are apt repositories that can be used to install and update pysoundanalyser. For other Linux distributions pysoundanalyser has to be installed from source (see Section Installation from source).

Installation on Debian

Binary packages for the Debian amd64 architecture are hosted on bintray. To install pysoundanalyser first install the apt-transport-https package if it is not already installed:

sudo apt-get install apt-transport-https

then add one of the following lines to /etc/apt/sources.list depending on your Debian version: For Jessie (stable):

deb https://dl.bintray.com/sam81/hearinglab jessie main

For Stretch (testing):

deb https://dl.bintray.com/sam81/hearinglab stretch main

Download the key with which the repository is signed and add it to the apt keyring:

wget -qO - https://bintray.com/user/downloadSubjectPublicKey?username=bintray | sudo apt-key add -

Refresh the package database and install the package:

sudo apt-get update
sudo apt-get install pysoundanalyser

Installation on Ubuntu LTS Releases

Binary packages for Ubuntu Long Term Support (LTS) releases are hosted on Launchpad. To install pysoundanalyser run the following commands:

sudo add-apt-repository ppa:samuele-carcagno/hearinglab
sudo apt-get update
sudo apt-get install pysoundanalyser

Installation on Windows

A Windows installer is provided on the downloads page:

http://samcarcagno.altervista.org/pysoundanalyser/pysoundanalyser.html

Installation on the Mac

The easiest way to install pysoundanalyser on the Mac is to use Pyzo as a Python distribution. The steps are similar as those for the installation with Pyzo on Windows (see below). Please, note that if you install with Pyzo you will need to use the PySide version of pysoundanalyser.

Installation from source

pysoundanalyser depends on Python and a handful of Python modules. There are two ways to obtain these dependencies. One is to install Python and all the dependencies “manually” (that is one by one). The other (and easier) way is to install a Python distribution that comes with a bundle of pre-installed modules. These include:

Step by step instructions to install pysoundanalyser on Windows with Pyzo are provided below. Although these instructions are specific to Windows the installation steps are similar on Mac OS X and Linux systems. If you get stuck at some point don’t hesitate to get in touch <sam.carcagno@gmail.com>.

Install with Pyzo on Windows

Download the latest version on Pyzo and unpack it to a folder of your choice. Download the Windows source package (PySide) of pysoundanalyser. Open the DOS command prompt and change directory to the folder where you unpacked Pyzo, which should contain the python.exe executable. For example:

cd C:\Users\audiolab\Desktop\pyzo2013c

once you’re in the Pyzo folder, you can instruct the Pyzo Python interpreter to run pysoundanalyser by calling python.exe followed by the path where the pysoundanalyser main file is located. For example:

python.exe "C:\Users\audiolab\Desktop\pysoundanalyser-pyside-0.2.81\pysoundanalyser.pyw"

Currently there is not an application launcher. There is, however, a file called pysoundanalyser-launcher.bat inside the scripts folder of the source distribution of pysoundanalyser that after some modifications can be used as a launcher. The content of the file is the following:

C:\Python32\python "C:\Python32\site-packages\pysoundanalyser.pyw"

The first statement C:\Python32\python is the path to the Python executable. The second statement is the path to the main file of the pysoundanalyser app. You simply need to replace those two statements to reflect the Python installation on your system. Following the example above, you would change the contents of the file to:

C:\Users\audiolab\Desktop\pyzo2013c\python.exe "C:\Users\audiolab\Desktop\pysoundanalyser-pyside-0.2.81\pysoundanalyser.pyw"

You can place the .bat launcher wherever you want, for example on your Desktop folder. Simply double click on it, and pysoundanalyser should start.

“Manual” Installation from Source

pysoundanalyser depends on the installation of a handful of other Python modules:

additionally it is necessary to install one of the modules providing Python bindings to the Qt widgets toolkit. There are three parallel versions of pysoundanalyser that support the major modules providing Python bindings to Qt (PyQt5, PyQt4, and PySide). You need to install only one of these modules, and use the corresponding version of pysoundanalyser

these programs need to be installed manually. Once these programs are installed you can proceed with the installtion of pysoundanalyser:

python3 setup.py install

you can then invoke pysoundanalyser from a terminal by typing the command

pysoundanalyser.pyw

Install Python and the Dependencies manually on Windows

Please, note that you will need Python version 3 or above to run pysoundanalyser.

To install the dependencies, download them from their respective websites. Make sure that you pick versions compatible with your architecture (64 or 32 bits), and compatible with you Python version.

After installing the dependencies, it is recommended to add the directory where the Python executable resides to the system PATH. In this way you can call python from a DOS shell by simply typing its name, rather than typing the full path to the Python executable.

By default python is installed in C:. The name of the Python directory depends on its version number, for example, if you installed Python version 3.2, the python directory will be C:\Python32. To add this directory to the system path go to My Computer and click Properties, then click Advanced System Settings. In the System Properties window click Environment Variables. There you will find an entry called Path. Select it and click Edit. Be careful not to remove any of the entries that are already written there because it could corrupt your system. Simply append the name of the full path of the folder where Python is installed, at the end of the other entries.

To run pysoundanalyser, unpack the pysoundanalyser .zip file containing the source code. Open a DOS shell, cd to the directory where you unzipped pysoundanalyser and launch it with the following command:

python pysoundanalyser.pyw

Currently there is not an application launcher. There is, however, a file called pysoundanalyser-launcher.bat inside the scripts folder of the source distribution of pysoundanalyser that after some modifications can be used as a launcher. The content of the file is the following:

C:\Python32\python "C:\Python32\site-packages\pysoundanalyser.pyw"

The first statement C:\Python32\python is the path to the Python executable. The second statement is the path to the main file of the pysoundanalyser app. You simply need to replace those two statements to reflect the Python installation on your system. You can place the .bat launcher wherever you want, for example on your Desktop folder. Simply double click on it, and pysoundanalyser should start.