3 <img src="/images/midi-tracer.png" alt="The MIDI Tracer window">
4 <figcaption class="center">
10 The <dfn>MIDI Tracer</dfn> window, which is accessed by selecting <kbd
11 class="menu">Window > MIDI Tracer</kbd> from the main menu, is similar to
12 the <a href="@@midi-list-editor">MIDI List Editor</a> in that it displays
13 MIDI information as tabular text, and has a vertical flow (i.e. the
14 events follow a top to bottom time-oriented order).
18 Its use is different however, as it is <em>not</em> bound to a specific
19 region or track; the MIDI shown in the MIDI Tracer window is any global input
20 or output Ardour presents to the system. As such, it is a very useful way to
21 monitor MIDI traffic, whether it is an external controller or device or the
22 input or output of any track.
26 The MIDI Tracer can list all types of MIDI and "audio" events, and <a href="@@midi-scene-automation">scene automation</a> and <a href="@@timecode-generators-and-slaves">timecode</a> events as well.
30 The window consists of:
35 <th><dfn>Port</dfn></th>
36 <td>A list of all the MIDI ports Ardour presents to the system. They are both
37 internal and external and are the same ports Ardour presents to JACK, if
41 <th>The events list</th>
42 <td>Where all the events for this port are listed, see below</td>
45 <th><dfn>Line history</dfn></th>
46 <td>How many lines should be kept in the events list; once this limit is
47 reached, older events will be removed from the list</td>
50 <th><dfn>Delta times</dfn></th>
51 <td>If checked, shows the times as the duration since the last event, instead
52 of <a href="@@on-clock-and-time">absolute times</a></td>
55 <th><dfn>Decimal</dfn></th>
56 <td>If checked, shows the MIDI data as decimal values instead of
60 <th><dfn>Enabled</dfn></th>
61 <td>If checked, events are displayed in the events list as they occur,
62 otherwise stops the logging</td>
65 <th><dfn>Auto-Scroll</dfn></th>
66 <td>If checked, the events list scrolls as new events are logged, keeping the
67 newest events on screen</td>
72 The events list displays the events as columns:
77 <th>Time of the event</th>
78 <td>Either absolute or relative, based on the <kbd class="option">Delta
79 times</kbd> checkbox</td>
82 <th>MIDI status (event type)</th>
83 <td>What MIDI events happened (e.g. Note On, Note Off, Pitch Bend, etc.)</td>
87 <td>The MIDI channel the event happened in</td>
90 <th>MIDI data bytes (event parameters)</th>
91 <td>Parameters of the event, e.g. for a Note On: what the <a
92 href="@@midi-notes-ref">note</a> was, and its velocity</td>