-
Notifications
You must be signed in to change notification settings - Fork 0
/
MANUAL
322 lines (222 loc) · 7.78 KB
/
MANUAL
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
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
____ ____ ____ ___ ____
(_ _)( _ \(_ _)/ __)/ _ _)
)( ) / _)(_( (__ \__ \
(__) (_)\_)(____)\___)(____/
Mighty tiny text-based chiptune tracker
Command Line Interface
Usage
trics [command] [<args>]
Without any argument trics will open song editor, but you will not
be able to save your song, so consider adding -o option.
Default command
trics [options] [song_file]
song_file - song file to open
Options:
-o output_file - Output song file
--midi device - Connect MIDI input device
--mc cc param - Map MIDI controll to parameter
-s - Play song without displaying interface
-h, --help - Show this help
-v, --version - Show version
Available commands
midi-list - show list of available midi devices
export - export song as an audio file
Keyboard Layout
General
ALT + s - go to song tab
ALT + p - go to pattern tab
ALT + i - go to instrument tab
ALT + w - go to wave tab
ALT + f - go to filter tab
ALT + a - go to arpeggio tab
CTRL + arrow or CTRL + h/l - switch tab
or mouse click
ALT + arrow or ALT + h/l - switch sub tab
or mouse click
y - copy table row/pattern/instrument/arpeggio
p - paste table row/pattern/instrument/arpeggio
CTRL + c - quit
Default and record mode
arrow or h/j/k/l - move cursor
CTRL + arrow or CTRL + j/k - move cursor one screen up/down
ALT + arrow or ALT + j/k - move cursor to the first/last row
SPACE or ENTER - edit mode
or mouse click
CTRL + SPACE - play from selection or stop
CTRL + r - start / stop recording
mouse wheel - scroll table
Edit mode
arrow or j/k - move parameter one step up/down
or mouse wheel
CTRL + arrow or CTRL + j/k - move parameter by octave
(12 steps up/down)
ALT + arrow or ALT + j/k - double/half parameter
ENTER - exit from edit mode saving changes
(where no auto exit)
ESC - exit from edit mode discarding changes
(where no auto exit)
DEL - empty value
= - note-off
Tip: If you accidentally hit CTRL + S press CTRL + Q to unfreeze your terminal emulator.
Notes Layout
_ _ _ _ _ _ _ _ _ _
|s|d| |g|h|j| |2|3| |5|6|7|
|_|_| |_|_|_| |_|_| |_|_|_| _
|z|x|c|v|b|n|m|q|w|e|r|t|y|u|i|
|_|_|_|_|_|_|_|_|_|_|_|_|_|_|_|
Interface
Number format
In trics all numeric parameters are integers and in the interface
they are represented as hex digits, for example: 80 in hex = 128 in dec.
Minimum numeric value is 00
Maximum for integers is ff (255), for booleans - 01
Different parameters may have different maximum and minimum allowed values.
Modes
Trics has three modes of operation "default", "edit" and "record".
In the default mode you can navigate around and play notes on the currently
selected instrument. You also can play instrument on top of the song as a kind
of solo.
In the edit mode you program parameter and notes values. To switch to the
edit mode select a parameter and press SPACE or just click the parameter with
your mouse.
In the record mode you can play notes on the selected instrument
and if the song is playing trics will record all the notes you've typed in
the selected pattern. When you start recording notes and your pattern is not
presetnted in any slot of the currently played bar, trics will place it
to the first empty slot of the bar in the song arrangement table.
Notes are recorded only to the first voice of the pattern. If the pattern
already contains some notes in the first voice column they will be
overwritten.
To switch to the record mode do not forget to select pattern and instrument
and when you're ready press CTRL + r, to exit the record mode press
CTRL + r again. When the record mode is active the pattern table and
the pattern tab title will become red.
Song arrangement tab
___________________________
| |
| *SONG PATT INST ARP | <---- Tabs
| |
| bp st title | <---- Main song parameters:
| 80 10 Song Title | bp - BPM (tempo)
| | st - Steps, number of steps in a pattern
| 00 -- 03 01 -- 03 ff a4 | -- title - Song title
| 00 -- 03 01 -- 03 ff a4 | |
| 00 -- 03 01 -- 03 ff a4 | |
| 00 -- 03 01 -- 03 ff a4 | |--- Pattern arrangement table
| 00 -- 03 01 -- 03 ff a4 | | enter pattern numbers here
| 00 -- 03 01 -- 03 ff a4 | | to arrange your song
| 01 43 -- -- -- -- -- -- | |
|> 01 43 -- -- -- -- -- -- | --
| |
| ^... CTRL + h 80 | <---- Shows the value of the edited parameter
|__________________________ |
|
--------------- Shows pressed keys and mouse events
">" Shows the bar that is currently playing
"^..." Indicates that there are more table rows hidden bellow or above.
Pattern tab
One pattern represents one bar of the song, it can contain 4 through 32 steps, each step represets 1/4 or 1/8 ... or 1/32 note length accroding to step setting of the song.
Instrument tab
Wave table tab
Filter table tab
Arpeggio tab
SONG *PATT INST ARP
## t1 t2
00 04 04
in nt ar in nt ar
00 C#1 -- -- --- --
00 C#1 -- -- --- --
> 00 C#1 -- -- --- --
00 C# -- -- --- --
00 === -- -- --- --
00 C#1 -- -- --- --
00 C#2 -- -- --- --
00 C# -- -- --- --
... ALT + K
```
SONG PATT *INST ARP
*MAIN WAVE FILT
## name
00 Lead synth
vl pn oc hr
ff 80 04 01
e aa ad as ar
00 00 00 00
x ds da dr
00 00 00
song_title_lo...
```
```
SONG PATT *INST ARP
MAIN *WAVE FILT
rp st
00 10
wv rm ra hs pw
00 + 00 + 00 + 01 = 00
00 + 00 + 00 + 01 = 00
00 + 00 + 00 + 01 = 00
00 + 00 + 00 + 01 = 00
00 + 00 + 00 + 01 = 00
00 + 00 + 00 + 01 = 00
00 + 00 + 00 + 01 = 00
00 + 00 + 00 + 01 = 00
... song_title_lo...
```
```
SONG PATT *INST ARP
MAIN WAVE *FILT
rp st
00 10
tp rs ct
00 = 01 = 00
00 + 01 + 00
00 + 01 + 00
00 + 01 + 00
00 + 01 + 00
00 + 01 + 00
00 + 01 + 00
00 + 01 + 00
... song_title_lo...
```
```
SONG PATT INST *ARP
## rp st name
00 01 10 Major third up
pt
= 00
+ 00
+ 00
+ 00
+ 00
+ 00
+ 00
+ 00
... song_title_lo...
```
Default template
Instruments
00 kick - Kick drum
01 snare - Snare drum
02 c_hat - Closed high-hat
03 o_hat - Open high-hat
10 lead - Lead synth voice
11 s_pluck - Short plucky synth
12 l_pluck - Long plucky synth
13 pad - Pad synth
14 sin_voice - Synth almost sin wave
15 synth_drop - Resonant synth drop
20 bass - Classic bass close to sin wave with punchy attack
21 saw_bass - Bass based on the saw
22 pluck_bass - Plucky bass synth
30 noize_up - Long noisy build-up
31 noize_down - Long noisy drop
Arpeggios
01 fast_up
02 fast_down
03 major_up
04 major_down
05 major_alt
06 minor_up
07 minor_down
08 minor_alt
09 power_alt