-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.txt
160 lines (101 loc) · 5.24 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
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
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
WARNING BETA
MOST FEATURES ARE ONLY MINIMALLY TESTED
Feel free to play around with the PhrasesPd editor and sequencer. If you are using PhrasesPd in a mission-critical capacity, please double-check everything you want to do in advance, in order to avoid potential unforeseen bugs.
PhrasesPd
PhrasesPd is a MIDI sequencer, for arbitrarily-sized grid controllers capable of using the Monome OSC communications format. It is for composing phrases of MIDI data, which can then be saved/loaded as songs, and combined in novel ways during performance. It is very informationally dense, capable of controlling long and complex songs from a single Monome 64, and yet offers considerable options for improvisation too.
PhrasesPd allows for polyphony, polyrhythms, ADC control of note and volume parameters, and generative transference of phrase activity.
It has an integrated phrase editor, which is controlled by a combination of computer keyboard, MIDI controller, and grid controller. Song data is saved as Lua table files, in a manner that is both executable and human-readable.
Monome Wiki page:
http://monome.org/docs/app:phrasespd
Dependencies:
Puredata-extended 0.43.4
TO-DO LIST (in rough order of desired implementation):
* --- Beta Release Goes Here ---
* Refactoring: Combine preferences files, clean things up in general
Quick-Start Guide:
1. Put the following files into your /pd/extra directory:
phrases-editor-and-sequencer.pd_lua
phrases-get-prefs.pd_lua
phrases-gui-generator.pd_lua
phrases-gui-tables.lua
phrases-keychord.pd_lua
phrases-keychord-tables.lua
phrases-main-tables.lua
2. Place the following files in the same directory as one another:
default.lua
phrases-hotseats.lua
phrases-makecolor.pd
phrases-prefs.lua
phrasespd.pd
The directory itself can be wherever, but preferably somewhere convenient in your directory structure, as your savefiles will be loaded from within the same directory (or a subdirectory, if you specify so).
3. Modify the contents of "phrases-prefs.lua" to reflect your setup and directory structure.
4. Change the Puredata MIDI settings to reflect your default MIDI-IN and MIDI-OUT devices.
5. Run "phrasespd.pd" in PureData.
6. You can now begin assembling phrases of MIDI data in the PhrasesPd editor, and playing them with your Monome.
7. To save your song data: Click the "Custom Savefile" box, type in the desired filename, and hit Enter. Then, to save your data there, type Shift-?-|.
8. To change the default loadfile hotseats, edit the contents of "phrases-hotseats.lua".
Monome communications prefix:
/phrases
Editor Commands:
(Note: These are the default key-commands, and can be changed by editing phrases-keychord-tables.lua)
Choose savefile name - Type a filename in the "Custom savefile" box in the main phrasespd.pd window, and hit Enter
Save file - Shift-?-|
Choose loadfile hotseat - Shift-[number] (hotseats 1-10), Shift-BackSpace-[number] (hotseats 11-20)
Enter custom loadfile name - Type a filename in the "Custom loadfile" box in the main phrasespd.pd window, and hit Enter
Load file - Shift-Tab-Enter (WARNING: Erases any unsaved changes)
Keystroke Panic (because current keychord detection is fallible): Space
Toggle between phrases - Any Monome button (while in REC mode)
Play phrase - Any Monome button (while in PLAY mode)
Previous phrase - Left
Next phrase - Right
Previous note - Up
Next note - Down
First note - Home
Inverse note - End
Page up - PageUp
Page down - PageDown
Toggle Recording/Play modes - Esc
Toggle between input panels - Insert
Toggle between number/pitch views - Shift-M
Toggle between MIDI Catch modes - Shift-O, Shift-P
Insert MIDI command - zsxdcvgbhnjm,lq2w3er5t6y7ui9o0p
Insert blank note - Backspace
Delete note - Delete
Undo - Shift-Tab-Z
Redo - Shift-Tab-Y
Set Copy Range Top - Shift-Tab-!
Set Copy Range Bottom - Shift-Tab-@
Unset Copy Range - Shift-Tab-#
Cut - Shift-Tab-X
Copy - Shift-Tab-C
Paste - Shift-Tab-V
Shift phrase up - Shift-Tab-Up
Shift phrase down - Shift-Tab-Down
Shift phrase left - Shift-Tab-Left
Shift phrase right - Shift-Tab-Right
Increase spacing - Shift-Up
Decrease spacing - Shift-Down
Increase MIDI channel - '
Decrease MIDI channel - ;
Default MIDI velocity +1 - =
Default MIDI velocity -1 - -
Default MIDI velocity +10 - +
Default MIDI velocity -10 - _
Octave +1 - ]
Octave -1 - [
Next command type - /
Previous command type - .
Move active note back by default velocity value - Shift-Q
Move active note forward by default velocity value - Shift-W
Move all notes in active phrase back by default velocity value - Shift-E
Move all notes in active phrase forward by default velocity value - Shift-R
Shift active note-byte down by default velocity value - Shift-A
Shift active note-byte up by default velocity value - Shift-S
Shift all note-bytes in phrase down by default velocity value - Shift-D
Shift all note-bytes in phrase up by default velocity value - Shift-F
Shift active velocity byte down by default velocity value - Shift-Z
Shift active velocity byte up by default velocity value - Shift-X
Shift all velocity-bytes in phrase down by default velocity value - Shift-C
Shift all velocity-bytes in phrase up by default velocity value - Shift-V
Add note-offs to active phrase before each note - Shift-Tab-A
Add note-offs to active phrase based on spacing value - Shift-Tab-S