Skip to content
netpd-server - Pd patch that connects netpd clients with each other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
includes
LICENSE.txt
README.md
netpd-server.pd

README.md

netpd-server

If you're wondering what this is about, you might be more interested to read about netpd. If you really are interested in running your own netpd-server, this is for you.

NOTE: Please be aware that there is always an instance of the netpd-server running on netpd.org:3025. You don't need to run this yourself for joining a netpd session.

netpd-server.pd is a Pd implementation of the protocol described in http://netpd.org/Protocol. It acts as relay for OSC messages sent to and from netpd clients.

How to run your own netpd-server

Make sure you have Pure Data and the necessary libraries (a.k.a "externals") installed. To run this patch, you need the following externals:

  • iemnet
  • osc
  • slip

As of Pd version 0.47 you can easily install externals through the menu 'Help'->'Find externals'. Make sure to install the version suitable for your platform (listed in black color as opposed to grey color).

Once the necessary externals are installed, you can load netpd-server.pd with Pd. Alternatively, you may want to launch Pd from the command-line in nogui-mode, since the patch doesn't provide any way of user interaction:

pd -nogui -open netpd-server.pd

NOTE: netpd-server.pd might also work correctly with Pd-extended using the included mrpeach library instead of the libraries from the list above. However, future support for this setup is not guaranteed.

TCP port

This patch opens a listening socket on the TCP port 3025. In order to successfully use the netpd-server, make sure this port is not blocked by a firewall nor used by another program on the same host.

You can change the default port 3025 by editing the patch. The part that can be edited is high-lighted in the patch. Make sure to save your changes after editing.

Connect clients with your own instance of netpd-server

Clients are pre-configured to connect to netpd.org, port 3025. If you want them to connect to your netpd-server, your users need to configure their clients accordingly. This can be done through the [pref] (http://www.netpd.org/NetpdPreferences) panel in [chat.pd] (http://www.netpd.org/Chat). Correct values for 'IP' (and 'Port', if you changed the default) need to be entered. Those settings can be saved.

Bugs and feature requests

Please report bugs, or send feature requests, to the author, either by mail to roman@netpd.org or by opening an issue on GitHub.

License

netpd-server.pd and its abstractions are released under the terms of the GNU General Public License. See LICENSE.txt for the full text.

You can’t perform that action at this time.