netpd
=====

is a CRNMME (Collaborative Realtime Networked Music Making Environment)
written in Pure Data. It allows many users to have a realtime jam
sessions with each other, connected over the net.
Users might contribute their own netpd-ized patches a.k.a. instruments
or use pre-existing ones. The set of patches, as well as the state of
each is synchronized between clients in order to provide identical
experience for every connected user.

  Read more:
  http://www.netpd.org

This is an all-in-one ready-to-go Windows application containing:
  - Pure Data 0.51-4
  - netpd 2.3.0
  - netpd-instruments
  - externals:
      * binfile
      * else
      * iemnet
      * iemlib
      * osc
      * slip
      * zexy


intro
=====

* Launch the netpd.exe in netpd-2.3.0 directory. Chat automatically connects
  to the server. You can now talk to other users currently online.
  Click *list* to get a list all connnected users.

* Click the unpatch button in chat to launch the unpatch instrument manager.
  If there is already a session going on, the instruments used in the running
  session are automatically loaded (they are first downloaded from other users,
  if necessary).

* Load instruments into the current session by clicking on any of the
  instrument names in the upper scroll list.
  Alternatively, just type the name of the instrument (without the
  extension `.pd`) into the input box and hit enter.

* Show an instrument's GUI by clicking on its name in unpatch's lower section.
  You can now manipulate the instrument's parameters. Any changes are instantaneously
  synchronized between clients. Anyone can manipulate anything, so please be
  cautious and considerate when joining an ongoing session.

If you're lucky, someone is online and might help you get started. This is the easiest
and fastest way to get accustomed to all the instruments and how they interact with each
other. Of course, you can explore the instruments on your own as well. Maybe start
with "master" and "sine".


help
====

If you need help, have questions about netpd, want to get into
contact with other netpd enthusiasts, please visit:

  https://untalk.netpd.org


copyright
=========

2008-2020, Roman Haefeli <roman@netpd.org>
Published under the Gnu Public License (GPL-2)


releases
========

2.3 (2021-03-18)
  * give chat and unpatch a facelift
  * load instruments from scroll list instead of openpanel
  * support unlimited nesting of dynamic loading with new abstraction
    [netpd-bus-order]. This allows effects to load other effects into
    themselves
  * restore support for loading from old text-based preset file format
  * broadcast loading from preset file to all clients for improved consistency
  * add debug message printing facility
  * support irc style /commands in chat (check with '/help')
  * add protected mode for unpatch. Protects from interactions with
    peers while developing instruments
  * refactor lots of internal stuff:
      * use $1.NETPD bus for everything in netpd_* abstractions
      * remove second number argument to [netpd-dump]. Use new [netpd-bus-order]
        to enforce order of state dumps.
      * only initialize instrument when necessary (e.g. not when receiving
        state from peer or from preset file)
      * only search for sync peer when necessary
      * indicate

2.2 (2020-05-01)
  * add support for OSC blob data
  * support audio transmissions (samples or live)
  * new netpd abstraction: [netpd_sample]
  * make instruments directory configurable
  * add configuration parameter for latency compensation

2.1 (2013-03-10)
  * Improved reliability of finding a sync peer (breaks
    compatibility with v2.0)
  * Added non-blocking until [netpd-nb-until]
  * Turning DSP off on dynamic creation is now a
    configurable option (see chat's preferences)
  * Prevent errors when checking for non-existing files
    (adds more dependencies, though)
  * Automatically load unpatch by cmdline option (useful
    for -nogui)
  * Turn on/off printing of all incoming and outgoing OSC
    message with cmdline option
  * Turn on/off state messages for testing and debugging
    with cmdline option

2.0 (2012-05-20)
  * Complete rewrite
  * Messaging layer based on OSC
  * Consequent use of namespaces
  * Improved and more reliable state synchronization
  * Faster patch synchronization
  * More intelligent dependency resolving
  * Multiple instances of the same instrument
  * Non-blocking network layer (less audio drop-outs)
  * Lots of bugfixes


links
=====

https://www.netpd.org
https://untalk.netpd.org
https://puredata.info
http://msp.ucsd.edu/software.html
https://github.com/reduzent/netpd
https://github.com/reduzent/netpd-instruments