We recommend that Windows users install and use OpenSoundscape using Windows Subsystem for Linux, because some of the machine learning and audio processing packages required by OpenSoundscape do not install easily on Windows computers. Below we describe the typical installation method. This gives you access to a Linux operating system (we recommend Ubuntu 20.04) in which to use Python and install and use OpenSoundscape. Using Ubuntu 20.04 is as simple as opening a program on your computer.
Get Ubuntu shell
If you don’t already use Windows Subsystem for Linux (WSL), activate it using the following:
Search for the “Powershell” program on your computer
Right click on “Powershell,” then click “Run as administrator” and in the pop-up, allow it to run as administrator
Install WSL2 (more information: https://docs.microsoft.com/en-us/windows/wsl/install-win10):
Restart your computer
Once you have WSL, follow these steps to get an Ubuntu shell on your computer:
Open Windows Store, search for “Ubuntu” and click “Ubuntu 20.04 LTS”
Click “Get”, wait for the program to download, then click “Launch”
An Ubuntu shell will open. Wait for Ubuntu to install.
Set username and password to something you will remember
sudo apt updateand type in the password you just set
We recommend installing OpenSoundscape in a package manager. We find that the easiest package manager for new users is “Anaconda,” a program which includes Python and tools for managing Python packages. Below are instructions for downloading Anaconda in the Ubuntu environment.
Open this page and scroll down to the “Anaconda Installers” section. Under the Linux section, right click on the link “64-Bit (x86) Installer” and click “Copy link”`
Download the installer:
Open the Ubuntu terminal
wgetthen paste the link you copied, e.g.: (the filename of your file may differ)
Execute the downloaded installer, e.g.: (the filename of your file may differ)
Press ENTER, read the installation requirements, press Q, then type “yes” and press enter to install
Wait for it to install
If your download hangs, press CTRL+C,
rm -rf ~/anaconda3and try again
Type “yes” to initialize
If you skipped this step, initialize your conda installation: run
source ~/anaconda3/bin/activateand then after that command has run,
Remove the downloaded file after installation, e.g.
Close and reopen terminal window to have access to the initialized Anaconda distribution
You can now manage packages with
Install OpenSoundscape in virtual environment
Create a Python (>=3.8) conda environment for opensoundscape:
conda create --name opensoundscape pip python=3.10(you can leave out the requirement of python 3.10, just make sure you have at least python 3.8)
Activate the environment:
conda activate opensoundscape
Install opensoundscape using pip:
pip install opensoundscape==0.9.1
If you see an error that says “No matching distribution found…”, your best bet is to use these commands to download then install the package:
cd git clone https://github.com/kitzeslab/opensoundscape.git cd opensoundscape/ pip install .
If you run into this error and you are on a Windows 10 machine:
(opensoundscape_environment) username@computername:~$ pip install opensoundscape==0.9.1 WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'NewConnectionError('<pip._vendor.urllib3.connection.HTTPSConnection object at 0x7f7603c5da90>: Failed to establish a new connection: [Errno -2] Name or service not known')': /simple/opensoundscape/
You may be able to solve it by going to System Settings, searching for “Proxy Settings,” and beneath “Automatic proxy setup,” turning “Automatically detect settings” OFF. Restart your terminal for changes to take effect. Then activate the environment and install OpenSoundscape using pip.