Contents

Tutorial structure and setup

Note

The content in this section draws heavily from the excellent example from the ISMIR 2020 tutorial: Open Source Tools & Data for Music Source Separation

How to Use This Website

On the left-hand side of this web page you’ll see the table of contents for the entire tutorial. If you don’t see the contents, click the hamburger (☰) icon to expand the left-hand column. On the right-hand side of the page you’ll see the table of contents for this particular page. To navigate to the next section you can either click on the next section on the tutorial’s table of contents on the left-hand side, or you can scroll to the bottom of the page to click the button on the bottom right to go to the next section.

Running Locally

We have included links to our github repo which has requirements.txt to set up your own environment so that you can use these tools locally, if you so choose. To run the notebook locally, select “.ipynb” (“Download Source File”) from the downloads drop down menu at the top right corner of the page.

If you choose to run locally, here are the recommended steps:

  1. Clone the github repo into a new directory.

  2. Make a new conda environment.

    • If you want to install using pip, activate your environment and the run pip install -r requirements.txt. Note that you should have ffmpeg installed prior to installing the requirements (instructions here).

  3. Run jupyter lab in your command line and navigate to the URL that it prints in the console
    (instructions here).

  4. Learn!

Getting in Touch

Github

There are links to the Github repository for this website and its notebooks at the top right corner of every page of this site.

Found a bug? Typo?

Feel free to open an issue here. This link is also at the top right corner of every page.

Note

Especially for those participating in the live tutorial, we’ll almost surely need to iron out a few kinks in the days immediately after we’re done. So do watch out for updates if something doesn’t quite work as it should.

Let’s get started!

Press the button on the bottom right to advance to the next section.