README.txt.win 4.75 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

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:
Roman Haefeli's avatar
Roman Haefeli committed
17
18
  - Pure Data 0.51-4
  - netpd 2.3.0
19
20
21
22
23
24
25
26
27
28
29
30
31
32
  - netpd-instruments
  - externals:
      * binfile
      * else
      * iemnet
      * iemlib
      * osc
      * slip
      * zexy


intro
=====

Roman Haefeli's avatar
Roman Haefeli committed
33
34
35
* 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.
36

Roman Haefeli's avatar
Roman Haefeli committed
37
38
39
40
* 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).
41

Roman Haefeli's avatar
Roman Haefeli committed
42
43
* Load instruments into the current session by clicking on any of the
  instrument names in the upper scroll list.
44
  Alternatively, just type the name of the instrument (without the
Roman Haefeli's avatar
Roman Haefeli committed
45
  extension `.pd`) into the input box and hit enter.
46

Roman Haefeli's avatar
Roman Haefeli committed
47
48
49
50
51
52
53
54
55
* 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".
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76


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
========

Roman Haefeli's avatar
Roman Haefeli committed
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
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

98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
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