L2Ork » Software

The fastest way to get a working L2Ork-compatible software setup is to:

install “Burrito Supreme” version of Pd-L2Ork
install L2Ork Compositions & Abstractions

The “Burrito Supreme” installer will provide you with all components necessary to have a setup equivalent to that of Pd-extended. The L2Ork abstractions are necessary only if you want to create/perform pieces specific to the L2Ork ensemble setup. These are not necessary for running the K12 module.

The instructions and download links for each of these steps are provided below.

IMPORTANT! For Linux users, if you are manually installing a deb file or trying to build your own version of pd-l2ork from scratch and find specific dependencies not satisfied, please contact us to report such inconsistencies. If you are looking to compile your own Linux version of pd-l2ork or wish to use a script-based tarball installer and want to make sure you have all the necessary libraries Pd-L2Ork relies on, please click here to access the page with the up-to-date instructions. Windows and OSX users should have all the libraries included with the installer.

Download Pd-L2Ork

Complete (a.k.a. ‘Burrito Supreme’) Installer

Pd-L2Ork version 2.x (updated 2021-10-23)

Pd-L2Ork version 1.x (Linux-only, currently in maintenance mode only)
- Packages for various Linux Distros
- Raspberry Pi arm6 deb (v.20160614)
- Raspberry Pi arm7 deb (v.20170119)
- Install instructions for 32 and 64-bit Intel platform
- Install instructions for Raspberry Pi

Source Code

Source tree snapshot on Pd-L2Ork 2.x Git

Source tree snapshot on Pd-L2Ork 1.x Git

Individual Externals

L2Ork externals sources (already included in the Burrito Supreme version):
- disis_munger~ (updated 12/30/2010)
  - requires flext library (a part of regular pd-extended, pd-l2ork version coming soon)
- disis_wiimote (updated 11/08/2012)
  - requires L2Ork version of CWiid library (updated 09/23/2015)
- disis_phasor~ (updated 05/22/2012)
  - sawtooth wave generator with a non-signal sync
- disis_netsend and disis_netreceive (updated 05/22/2012)
  - the backbone of L2Ork communication
- spectdelay~ (updated 05/22/2012)
  - Pd port of John Gibson’s jg.spectdelay~

Changelog

Any changes from November 2011 are now posted as part of git commits.
Old pre-git Changelog (last updated 2/11/2012)

L2Ork Compositions & Abstractions

PD-L2Ork Compositions & Abstractions¹ (temporarily down)
- Necessary for opening L2Ork patches
- Provides core infrastructure for UI, streamlined implementation of core DSP techniques, networking, and input device data analysis
- Also includes a snapshot of the RjDj Library
- USE THIS TO:
  - gain access to various useful abstractions commonly used inside L2Ork-specific patches
  - ensure 100% compatibility with L2Ork environment

¹ These are continually evolving, so please make sure to communicate questions/concerns on the L2Ork-Dev mailing list.

Install Instructions for Linux OS

IMPORTANT! All Pd-l2Ork installer tarballs use unique identifiers/paths, so they should coexist happily next to other installs of Pd. This, however, also means that they may not be able to find externals belonging to other preexisting Pd installs and that is a good thing since Pd-l2Ork changes some of the files externals may rely upon and as such mixing Pd-l2Ork with externals from other Pd iterations may result in unexpected crashes and instabilities. Therefore, to ensure maximum stability please couple Pd-L2Ork only with externals provided on this page or recompile your own making sure you are referencing appropriate source files.

As of July 2015, Pd-L2Ork 1.x deb installer does not conflict with any of the Pd-vanilla or Pd-extended packages, allowing for various flavors of Pd to happily coexist on the same machine. Yay! Pd-L2Ork 2.x installer should co-exist happily alongside both Pd and Purr-Data, with the exception of Linux where, pending updates in the Purr-Data source, both share the pd-l2ork executable and its paths.

To manually install a deb version (the old way), simply double-click on the downloaded deb file or type the following command in the terminal from the folder where the downloaded deb file is located:

sudo dpkg -i pd-l2ork*deb

This will install all the supporting libraries, warn you of any conflicts with other packages (e.g. pd-utils), as well as set up pd-l2ork on your machine.

If you encounter errors due to missing packages, this is most likely because you did not install supporting libraries listed at the top of this page. You can, however, correct this easily by running the following command:

sudo apt-get -f install

If everything goes well, you will be presented with an option of installing a collection of packages. Please review that you are ok with installing/removing suggested packages and if so, press “Y” to continue. Once this process is complete, pd-l2ork should be installed and ready for use.

Once install process is complete, to run Pd-l2ork simply click on the application shortcut or type:

pd-l2ork

Please note that running pd-l2ork with no start-up flags will provide you with default (conservative) settings which will likely result in poor audio performance. For optimal perfomance you will ideally need a lowlatency kernel, an audio group with real-time privileges, using JACK audio server, and running pd-l2ork with -rt flag. The easiest way to achieve this is to:

Use qjackctl to configure and start JACK server with real-time privileges
Start pd-l2ork (or pd-l2ork-k12) using the shortcut from the application menu

If you are using Ubuntu Unity and have the shortcut in the Ubuntu Launcher, right-clicking on the shortcut will provide you with additional options.

Building Pd-L2Ork from Source

To compile from source, follow the three-step instructions found in the git repository’s README.md.

Questions? Please contact us via the L2Ork-Dev public mailing list.