Skip to content

Commit

Permalink
Update tutorial and index.md
Browse files Browse the repository at this point in the history
  • Loading branch information
agraef committed Jul 22, 2024
1 parent 27bc855 commit d2d4e01
Show file tree
Hide file tree
Showing 2 changed files with 33 additions and 15 deletions.
14 changes: 7 additions & 7 deletions index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,16 @@

**pd-lua** is Claude Heiland-Allen's [Pd][] loader extension for the [Lua][] scripting language. In a nutshell, it lets you program Pd objects in Lua.

The present version has been forked from [umlaeute's repository](https://anonscm.debian.org/git/pkg-multimedia/pd-lua.git) on Debian's Salsa server. It provides Lua 5.3+ compatibility, support for [Purr Data][] (a modern flavor of Pd) and [plugdata][] (another modern flavor of Pd which can also be run as a plug-in inside a DAW), some compilation fixes to make sure that the source builds on current systems (Linux, macOS, Windows), various bug fixes, and, last but not least, a [tutorial][] to help you get started using pd-lua. Moreover, it includes the latest help and example patches which have been updated and reorganized by Alexandre Porres.
The present version was forked from [umlaeute's repository](https://anonscm.debian.org/git/pkg-multimedia/pd-lua.git) on Debian's Salsa server. It provides Lua 5.3+ compatibility, support for [Purr Data][] (a modern flavor of Pd) and [plugdata][] (another modern flavor of Pd which can also be run as a plug-in inside a DAW), some compilation fixes to make sure that the source builds on current systems (Linux, macOS, Windows), various bug fixes and improvements (including Timothy Schoen's signal and graphics support), and, last but not least, a [tutorial][] to help you get started using pd-lua. Moreover, it includes the latest help and example patches which have been updated and reorganized by Alexandre Porres.

**Quick links:**

- [**Downloads**](https://github.com/agraef/pd-lua/releases): This is where you find source tarballs and binaries for **Ubuntu**, **Mac and Windows**. These are ready to be used with vanilla [Pd][]; [Purr Data][] already includes pd-lua and has it enabled by default.

- [**Arch packages**](https://www.archlinux.org/): pd-lua is available in the official [Arch community repositories](https://www.archlinux.org/packages/community/x86_64/pd-lua/), and also from the [AUR](https://aur.archlinux.org/packages/pd-lua-git/); the latter builds pd-lua straight from the current git sources.
- [**Arch packages**](https://www.archlinux.org/): pd-lua is available in the official [Arch extra repositories](https://www.archlinux.org/packages/extra/x86_64/pd-lua/), and also from the [AUR](https://aur.archlinux.org/packages/pd-lua-git/); the latter builds pd-lua straight from the current git sources.

- [**Debian package**](https://salsa.debian.org/multimedia-team/pd/pd-lua): The official Debian package is maintained by IOhannes Zmölnig.

- [**Deken package**](http://deken.puredata.info/library/pdlua): The Deken package is maintained by Alexandre Porres.

- [**Sources**](https://github.com/agraef/pd-lua): Github repository with the latest source code. See [Installation](#installation) below.

Expand All @@ -23,9 +26,7 @@ Enter pd-lua, the Pd programmer's secret weapon, which lets you develop your ext

pd-lua was originally written by Claude Heiland-Allen, with contributions by Frank Barknecht and Martin Peach, according to the original source. Claude's repository is still online at <https://code.mathr.co.uk/pdlua>; please also check his website at <https://mathr.co.uk/>, and <https://mathr.co.uk/blog/lua.html> for Lua-related content on his blog (including pd-lua's original announcement).

Martin Peach took over maintenance of pd-lua in 2011, you can find that part of the history in Pd's old [svn repository](https://sourceforge.net/p/pure-data/svn/HEAD/tree/trunk/externals/loaders/pdlua/) at SourceForge, including IOhannes Zmölnig's loader update for Pd 0.47. The present source is a fork of IOhannes' repository at <https://anonscm.debian.org/git/pkg-multimedia/pd-lua.git>, from which the official Debian packages are built. This in turn is apparently based on the 0.7.3 version of pd-lua in Pd's svn repository.

Apart from the loader update, it seems that pd-lua has been in maintenance mode since 2014, when Martin added Lua 5.2 support, so functionality-wise all these variants shouldn't differ. However, neither Claude's upstream nor the version maintained by Martin and IOhannes have ever been updated for the latest Lua versions. The present version is actively maintained, works with Lua 5.3 and later, and you're invited to submit bug reports and pull requests to help with keeping pd-lua current and useful to Pd and Lua programmers.
Martin Peach took over maintenance of pd-lua in 2011, you can find that part of the history in Pd's old [svn repository](https://sourceforge.net/p/pure-data/svn/HEAD/tree/trunk/externals/loaders/pdlua/) at SourceForge, including IOhannes Zmölnig's loader update for Pd 0.47. The present source started as a fork of IOhannes' repository at <https://anonscm.debian.org/git/pkg-multimedia/pd-lua.git>, from which the official Debian packages are built. This in turn was based on the 0.7.3 version of pd-lua in Pd's svn repository at the time. But it has since been updated to the present source, which is actively maintained and works with Lua 5.3 and later. You're invited to submit bug reports and pull requests to help with keeping pd-lua current and useful to Pd and Lua programmers.

## Installation

Expand All @@ -39,4 +40,3 @@ Building and installing from source is quite easy, once you have the requisite d
[Purr Data]: https://agraef.github.io/purr-data/
[plugdata]: https://github.com/plugdata-team/plugdata
[tutorial]: https://agraef.github.io/pd-lua/tutorial/pd-lua-intro.html
[ELSE]: https://github.com/porres/pd-else
Loading

0 comments on commit d2d4e01

Please sign in to comment.