About [pdsheefa]

Written for use with Pure Data, the pdsheefa library provides externals and patches to provide support for creating pd-based SPIN SPIN Framework clients for scene management (show control) and audio rendering. The library contains several objects related to distributed network control. Control signals can be managed, filtered and redirected using several utility objects and abstractions. There is support for simple HID devices (mouse, keyboard, joysticks) and the Ubisense tracking system. Some of the patches and extenals in this library, were taken from other (now frozen) repositories, such as "audioscape", spinwidgets, and pdsheefa-0.3.6. The library also consolidates the xjimmies library (from nSLAM).

License: GPL

Authors: Mike Wozniewski, Zack Settel.

Developed in partnership with:

Platform compatibility:

Linux, MacOS and Windows (99%)

Download & Install binary package

Download the latest tarballs from:

  1. Unpack the tarball.
  2. Add that path to the list of searched paths in Pd (ie, using the "File > Path" menu in Linux, or "Pd > Preferences > Path" in OSX or Windows)

Typical paths are:

  • OSX: /Users/userName/Library/Pd/pdsheefa
  • Linux: /home/userName/pd-externals/pdsheefa
  • Windows: C:\Libraries\pd-externals\pdsheefa

(see instructions in the README in the pdsheefa directory)


The pdsheefa library requires pd-extended

for LINUX:

Go to the followings site:

locate your particular linux version, then plug in the name in the wget URL below:
sudo apt-get install tk tcllib libmp3lame0 libquicktime1 libimlib2
wget http://sourceforge.net/projects/pure-data/files/pd-extended/0.43.4/pd-extended_0.43.4-1-YOUR_VERSION.deb/download
sudo dpkg -i Pd-0.42.5-extended-ubuntu-lucid-i386.deb

for MacOS:

# then double-click the .dmg and drag the app to your Applications folder

if require a build for a specific version of MacOS,

Go to the followings site:

locate your particular macOS version, and click on it to download (.dmg) and then install

for Windows:

use the windows installer at:

Other dependencies ( Linux only ):

install liblo (see following section)

Building from source

install LIBLO

compile from sources:




sudo port install --enforce-variants liblo +universal


sudo apt-get install liblo


build from source, our use the following (x86) libs, if all else fails


Build pdsheefa from sources


set up your development environment first
follow instructions at


Get and make sources:

MacOS, Windows and Linux

git clone https://code.sat.qc.ca/redmine/pdsheefa.git
cd pdsheefa
make all
sudo make install-all

If you want the lite version of pdsheefa (no externals for sensors), replace the last two lines with:

sudo make install

NOTE: If you've installed pdsheefa from source, the typical search path that you need to specify in Pd-Extended is:



pdsheefa was initially created as part of the realtime protoyping environment for the SPIN Framework (formerly Audioscape). This networked client/server framework provides a distributed architecture for the management of shared virtual environments. A server maintains the state of 3D content, where client applications can connect and send messages to move content, or receive messages when the content has been modified. Clients typically include editors (immersive display systems, audio spatializers), editing programs/scripts, motion tracking systems, mapping applications, etc. (MORE)

Currently pdsheefa is used for audio rendering in conjunction with spatOS [[http://code.sat.qc.ca/redmine/projects/spatosc/wiki]], which provides a link between applications like Unity3D and audio rendering engines for large multichannel audio displays (domes etc.)