Commit 64b7cd32 authored by Albert Gräf's avatar Albert Gräf

Update the 'Where to Get It' section.

parent 65fd6a64
......@@ -6,10 +6,12 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<title>Purr-Data-Intro</title>
<style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
span.underline{text-decoration: underline;}
div.column{display: inline-block; vertical-align: top; width: 50%;}
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
ul.task-list{list-style: none;}
</style>
<link rel="stylesheet" href="github-pandoc.css" />
<!--[if lt IE 9]>
......@@ -21,7 +23,7 @@
<p>Albert Gräf &lt;<a href="mailto:aggraef@gmail.com" class="email">aggraef@gmail.com</a>&gt;<br />
Computer Music Dept., Institute of Art History and Musicology<br />
Johannes Gutenberg University (JGU) Mainz, Germany<br />
November 2019</p>
May 2020</p>
<p>This document is licensed under <a href="https://creativecommons.org/licenses/by-sa/4.0/">CC BY-SA 4.0</a>. Other formats: <a href="Purr-Data-Intro.md">Markdown</a> source, <a href="Purr-Data-Intro.pdf">PDF</a><br />
Permanent link: <a href="https://agraef.github.io/purr-data-intro/" class="uri">https://agraef.github.io/purr-data-intro/</a></p>
<p><strong>Purr Data</strong> a.k.a. <strong>Pd-l2ork 2</strong> is an improved version of Miller Puckette’s interactive computer music and multimedia software <strong>Pd</strong>. This document provides new or prospective Purr Data users with a gentle introduction to the program and some helpful information to get started.</p>
......@@ -48,10 +50,9 @@ Permanent link: <a href="https://agraef.github.io/purr-data-intro/" class="uri">
<center>
<img src="purr.png" alt="logo" style="width: 10%; height: 10%" />
</center>
<h2 id="where-to-get-it">Where to Get It</h2>
<p>Jonathan Wilkes maintains the Purr Data sources in GitLab at <a href="https://git.purrdata.net/jwilkes/purr-data" class="uri">https://git.purrdata.net/jwilkes/purr-data</a>. There’s also a mirror of this repository at Github which serves as a one-stop shop for the latest source and the available releases, including pre-built packages for Linux, macOS and Windows. You can find this at <a href="https://agraef.github.io/purr-data/" class="uri">https://agraef.github.io/purr-data/</a>. The latest packages for Linux (Debian, Raspbian, Ubuntu), macOS and Windows are available at <a href="https://github.com/agraef/purr-data/releases" class="uri">https://github.com/agraef/purr-data/releases</a>. The Linux packages are in Debian format (.deb files), the Windows package is distributed as an installer executable (.exe file). Normally you can just run the .deb or .exe packages by double-clicking them in your file manager, and walk through the installation procedure. The Mac package is distributed as a disk image (.dmg file); double-clicking the disk image in Finder opens a new Finder window, in which you can drag the application to your Application folder. The Mac and Windows packages should be self-contained, while the .deb packages will pull in a lot of dependencies, which may require some fiddling. (If you’re running Ubuntu or one of its derivatives, and the .deb packages give you trouble, try using the JGU Ubuntu packages instead, see below.)</p>
<p>At JGU we also maintain a collection of Linux packages for Arch Linux (via the <a href="https://aur.archlinux.org/">Arch User Repositories</a> a.k.a. AUR) and recent openSUSE, Debian and Ubuntu releases (via the OBS a.k.a. <a href="https://build.opensuse.org/project/show/home:aggraef">Open Build System</a>). The OBS also offers binary packages for Arch Linux. More information and installation instructions can be found at the <a href="https://github.com/agraef/purr-data/wiki/Installation#linux">Installation</a> wiki page. Besides Purr Data, these repositories also contain the “classic” Pd-l2ork. Moreover, two additional programming extensions for Pd are available which enable you to run <a href="http://faust.grame.fr/">Faust</a> and <a href="https://agraef.github.io/pure-lang/">Pure</a> externals in Pd-l2ork and Purr Data. The JGU packages also offer the advantage that they let you install both classic Pd-l2ork and Purr Data on the same system.</p>
<p>Jonathan Wilkes maintains the Purr Data sources in GitLab at <a href="https://git.purrdata.net/jwilkes/purr-data" class="uri">https://git.purrdata.net/jwilkes/purr-data</a>. There’s also a mirror of this repository at Github which serves as a one-stop shop for the latest source and the available releases, including pre-built packages for <strong>macOS</strong> and <strong>Windows</strong>. You can find this at <a href="https://agraef.github.io/purr-data/" class="uri">https://agraef.github.io/purr-data/</a>. The latest packages are available at <a href="https://github.com/agraef/purr-data/releases" class="uri">https://github.com/agraef/purr-data/releases</a>. The Mac and Windows packages should be self-contained. The Windows package is distributed as an installer executable (.exe file). Normally you can just run this package by double-clicking it in your file manager, and walk through the installation procedure. The Mac package is distributed as a disk image (.dmg file); double-clicking the disk image in Finder opens a new Finder window, in which you can drag the application to your Application folder.</p>
<p><strong>Linux users:</strong> At JGU we maintain a collection of Linux packages for Arch Linux (via the <a href="https://aur.archlinux.org/">Arch User Repositories</a> a.k.a. AUR) and recent openSUSE, Debian and Ubuntu releases (via the OBS a.k.a. <a href="https://build.opensuse.org/project/show/home:aggraef">Open Build System</a>). The OBS also offers binary packages for Arch Linux. More information and installation instructions can be found at the <a href="https://github.com/agraef/purr-data/wiki/Installation#linux">Installation</a> wiki page. Besides Purr Data, these repositories also contain the “classic” Pd-l2ork. Moreover, two additional programming extensions for Pd are available which enable you to run <a href="http://faust.grame.fr/">Faust</a> and <a href="https://agraef.github.io/pure-lang/">Pure</a> externals in Pd-l2ork and Purr Data. The JGU packages also offer the advantage that they let you install both classic Pd-l2ork and Purr Data on the same system.</p>
<p>Of course, it is also possible to build Purr Data from source. With the latest additions to the build system, this task has become a lot less daunting than it used to be, and the Purr Data website has some <a href="https://agraef.github.io/purr-data/#building-from-source">instructions</a>. However, because of the large number of included externals, the build process is rather involved, requires a lot of 3rd party dependencies, and takes quite a while even on modern high-end hardware. Therefore, unless your system isn’t officially supported or you have specific requirements forcing you to compile from source, we recommend using the available binaries.</p>
<h2 id="getting-started">Getting Started</h2>
<p>Once you’ve installed Purr Data, you can launch it from the desktop environment as usual. On Linux, you can just run <code>pd-l2ork</code> from the command line, or look in your desktop environment’s program menu or launcher for the <code>Pd-L2Ork</code> entry and click on that. (If you installed Purr Data from one of the JGU packages, use the <code>purr-data</code> command or the <code>Purr-Data</code> desktop icon instead.)</p>
......@@ -72,6 +73,7 @@ Permanent link: <a href="https://agraef.github.io/purr-data-intro/" class="uri">
<figure>
<img src="prefs-audio+midi.png" id="fig:fig2" alt="" /><figcaption>Figure 2: Audio and MIDI setup.</figcaption>
</figure>
<p>The setup on Windows works in a similar fashion. More information for Linux users can be found in the <a href="https://github.com/agraef/purr-data/wiki/Installation#linux-users">wiki</a>.</p>
<p>One pitfall of the Pd engine is that it does not rescan the devices if you connect new external audio or MIDI gear while Purr Data is already running. Thus you need to relaunch the program to make the new devices show up in the preferences. In the case of MIDI, it is easy to work around this limitation by employing virtual MIDI devices, which ALSA MIDI does by default. On the Mac you’d use the <a href="https://sites.google.com/site/mfalab/mac-stuff/how-to-use-the-iac-driver">IAC</a> devices, on Windows a MIDI loopback driver such as <a href="http://www.tobias-erichsen.de/software/loopmidi.html">loopMIDI</a> for that purpose. You then wire these up to the MIDI hardware using a separate patchbay program. A similar approach is possible with audio loopback software such as <a href="http://www.jackaudio.org/">Jack</a>.</p>
<h3 id="gui-and-startup-options">GUI and Startup Options</h3>
<p>The GUI theme can be selected on the “GUI” tab (see fig. 3, left). The changes will be applied immediately. Purr Data provides various different GUI themes out of the box. Note that the GUI themes are in fact just CSS files in Purr Data’s library directory, so if you’re familiar with HTML5 and CSS then you can easily change them or create your own. Another useful option on the GUI tab is “save/load zoom level with patch”. Purr Data can zoom any patch window to 16 different levels, and this option, when enabled, allows you to store the current zoom level when a patch is saved, and then later restore the zoom level when the patch gets reloaded. The remaining options on the GUI tab are related to the help browser, we’ll discuss these in section <a href="#configuring-the-help-browser">Configuring The Help Browser</a> below.</p>
......
......@@ -3,7 +3,7 @@
Albert Gräf <<aggraef@gmail.com>>
Computer Music Dept., Institute of Art History and Musicology
Johannes Gutenberg University (JGU) Mainz, Germany
November 2019
May 2020
This document is licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
Other formats: [Markdown](Purr-Data-Intro.md) source, [PDF](Purr-Data-Intro.pdf)
......@@ -50,9 +50,9 @@ We also refer to Bukvic's original Pd-l2ork version as Pd-l2ork 1.0 or "classic"
## Where to Get It
Jonathan Wilkes maintains the Purr Data sources in GitLab at <https://git.purrdata.net/jwilkes/purr-data>. There's also a mirror of this repository at Github which serves as a one-stop shop for the latest source and the available releases, including pre-built packages for Linux, macOS and Windows. You can find this at <https://agraef.github.io/purr-data/>. The latest packages for Linux (Debian, Raspbian, Ubuntu), macOS and Windows are available at <https://github.com/agraef/purr-data/releases>. The Linux packages are in Debian format (.deb files), the Windows package is distributed as an installer executable (.exe file). Normally you can just run the .deb or .exe packages by double-clicking them in your file manager, and walk through the installation procedure. The Mac package is distributed as a disk image (.dmg file); double-clicking the disk image in Finder opens a new Finder window, in which you can drag the application to your Application folder. The Mac and Windows packages should be self-contained, while the .deb packages will pull in a lot of dependencies, which may require some fiddling. (If you're running Ubuntu or one of its derivatives, and the .deb packages give you trouble, try using the JGU Ubuntu packages instead, see below.)
Jonathan Wilkes maintains the Purr Data sources in GitLab at <https://git.purrdata.net/jwilkes/purr-data>. There's also a mirror of this repository at Github which serves as a one-stop shop for the latest source and the available releases, including pre-built packages for **macOS** and **Windows**. You can find this at <https://agraef.github.io/purr-data/>. The latest packages are available at <https://github.com/agraef/purr-data/releases>. The Mac and Windows packages should be self-contained. The Windows package is distributed as an installer executable (.exe file). Normally you can just run this package by double-clicking it in your file manager, and walk through the installation procedure. The Mac package is distributed as a disk image (.dmg file); double-clicking the disk image in Finder opens a new Finder window, in which you can drag the application to your Application folder.
At JGU we also maintain a collection of Linux packages for Arch Linux (via the [Arch User Repositories](https://aur.archlinux.org/) a.k.a. AUR) and recent openSUSE, Debian and Ubuntu releases (via the OBS a.k.a. [Open Build System](https://build.opensuse.org/project/show/home:aggraef)). The OBS also offers binary packages for Arch Linux. More information and installation instructions can be found at the [Installation](https://github.com/agraef/purr-data/wiki/Installation#linux) wiki page. Besides Purr Data, these repositories also contain the "classic" Pd-l2ork. Moreover, two additional programming extensions for Pd are available which enable you to run [Faust](http://faust.grame.fr/) and [Pure](https://agraef.github.io/pure-lang/) externals in Pd-l2ork and Purr Data. The JGU packages also offer the advantage that they let you install both classic Pd-l2ork and Purr Data on the same system.
**Linux users:** At JGU we maintain a collection of Linux packages for Arch Linux (via the [Arch User Repositories](https://aur.archlinux.org/) a.k.a. AUR) and recent openSUSE, Debian and Ubuntu releases (via the OBS a.k.a. [Open Build System](https://build.opensuse.org/project/show/home:aggraef)). The OBS also offers binary packages for Arch Linux. More information and installation instructions can be found at the [Installation](https://github.com/agraef/purr-data/wiki/Installation#linux) wiki page. Besides Purr Data, these repositories also contain the "classic" Pd-l2ork. Moreover, two additional programming extensions for Pd are available which enable you to run [Faust](http://faust.grame.fr/) and [Pure](https://agraef.github.io/pure-lang/) externals in Pd-l2ork and Purr Data. The JGU packages also offer the advantage that they let you install both classic Pd-l2ork and Purr Data on the same system.
Of course, it is also possible to build Purr Data from source. With the latest additions to the build system, this task has become a lot less daunting than it used to be, and the Purr Data website has some [instructions](https://agraef.github.io/purr-data/#building-from-source). However, because of the large number of included externals, the build process is rather involved, requires a lot of 3rd party dependencies, and takes quite a while even on modern high-end hardware. Therefore, unless your system isn't officially supported or you have specific requirements forcing you to compile from source, we recommend using the available binaries.
......@@ -90,6 +90,8 @@ You can redo this procedure at any time if needed. Note that it is usually possi
![Audio and MIDI setup.](prefs-audio+midi.png){#fig:fig2}
The setup on Windows works in a similar fashion. More information for Linux users can be found in the [wiki](https://github.com/agraef/purr-data/wiki/Installation#linux-users).
One pitfall of the Pd engine is that it does not rescan the devices if you connect new external audio or MIDI gear while Purr Data is already running. Thus you need to relaunch the program to make the new devices show up in the preferences. In the case of MIDI, it is easy to work around this limitation by employing virtual MIDI devices, which ALSA MIDI does by default. On the Mac you'd use the [IAC](https://sites.google.com/site/mfalab/mac-stuff/how-to-use-the-iac-driver) devices, on Windows a MIDI loopback driver such as [loopMIDI](http://www.tobias-erichsen.de/software/loopmidi.html) for that purpose. You then wire these up to the MIDI hardware using a separate patchbay program. A similar approach is possible with audio loopback software such as [Jack](http://www.jackaudio.org/).
### GUI and Startup Options
......
No preview for this file type
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment