xref: /freebsd/usr.bin/mididump/mididump.1 (revision f57efe95cc25ae527c632d4ffcf064799f922216)
1*f57efe95SChristos Margiolis.\"-
2*f57efe95SChristos Margiolis.\" SPDX-License-Identifier: BSD-2-Clause
3*f57efe95SChristos Margiolis.\"
4*f57efe95SChristos Margiolis.\" Copyright (c) 2024 The FreeBSD Foundation
5*f57efe95SChristos Margiolis.\"
6*f57efe95SChristos Margiolis.\" Portions of this software were developed by Christos Margiolis
7*f57efe95SChristos Margiolis.\" <christos@FreeBSD.org> under sponsorship from the FreeBSD Foundation.
8*f57efe95SChristos Margiolis.\"
9*f57efe95SChristos Margiolis.\" Redistribution and use in source and binary forms, with or without
10*f57efe95SChristos Margiolis.\" modification, are permitted provided that the following conditions
11*f57efe95SChristos Margiolis.\" are met:
12*f57efe95SChristos Margiolis.\" 1. Redistributions of source code must retain the above copyright
13*f57efe95SChristos Margiolis.\"    notice, this list of conditions and the following disclaimer.
14*f57efe95SChristos Margiolis.\" 2. Redistributions in binary form must reproduce the above copyright
15*f57efe95SChristos Margiolis.\"    notice, this list of conditions and the following disclaimer in the
16*f57efe95SChristos Margiolis.\"    documentation and/or other materials provided with the distribution.
17*f57efe95SChristos Margiolis.\"
18*f57efe95SChristos Margiolis.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19*f57efe95SChristos Margiolis.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20*f57efe95SChristos Margiolis.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21*f57efe95SChristos Margiolis.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22*f57efe95SChristos Margiolis.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23*f57efe95SChristos Margiolis.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24*f57efe95SChristos Margiolis.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25*f57efe95SChristos Margiolis.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26*f57efe95SChristos Margiolis.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27*f57efe95SChristos Margiolis.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28*f57efe95SChristos Margiolis.\" SUCH DAMAGE.
29*f57efe95SChristos Margiolis.\"
30*f57efe95SChristos Margiolis.Dd September 14, 2024
31*f57efe95SChristos Margiolis.Dt MIDIDUMP 1
32*f57efe95SChristos Margiolis.Os
33*f57efe95SChristos Margiolis.Sh NAME
34*f57efe95SChristos Margiolis.Nm mididump
35*f57efe95SChristos Margiolis.Nd dump MIDI events
36*f57efe95SChristos Margiolis.Sh SYNOPSIS
37*f57efe95SChristos Margiolis.Nm
38*f57efe95SChristos Margiolis.Op Fl t
39*f57efe95SChristos Margiolis.Ar device
40*f57efe95SChristos Margiolis.Sh DESCRIPTION
41*f57efe95SChristos MargiolisThe
42*f57efe95SChristos Margiolis.Nm
43*f57efe95SChristos Margiolisutility is used to dump MIDI 1.0 events in real-time.
44*f57efe95SChristos Margiolis.Pp
45*f57efe95SChristos MargiolisThe options are as follows:
46*f57efe95SChristos Margiolis.Bl -tag -width "-t"
47*f57efe95SChristos Margiolis.It Fl t
48*f57efe95SChristos MargiolisPrint "Timing Clock" events.
49*f57efe95SChristos MargiolisThese events are not printed by default, as they tend to clutter output.
50*f57efe95SChristos Margiolis.El
51*f57efe95SChristos Margiolis.Pp
52*f57efe95SChristos MargiolisThe
53*f57efe95SChristos Margiolis.Ar device
54*f57efe95SChristos Margiolisargument corresponds to the MIDI device (e.g.
55*f57efe95SChristos Margiolis.Pa /dev/umidi0.0 ) .
56*f57efe95SChristos Margiolis.Sh SEE ALSO
57*f57efe95SChristos Margiolis.Rs
58*f57efe95SChristos Margiolis.%T Summary of MIDI 1.0 Messages
59*f57efe95SChristos Margiolis.%U https://midi.org/summary-of-midi-1-0-messages
60*f57efe95SChristos Margiolis.Re
61*f57efe95SChristos Margiolis.Rs
62*f57efe95SChristos Margiolis.%T Expanded MIDI 1.0 Messages List (Status Bytes)
63*f57efe95SChristos Margiolis.%U https://midi.org/expanded-midi-1-0-messages-list
64*f57efe95SChristos Margiolis.Re
65*f57efe95SChristos Margiolis.Rs
66*f57efe95SChristos Margiolis.%T Standard MIDI-File Format Spec. 1.1, updated
67*f57efe95SChristos Margiolis.%U https://www.music.mcgill.ca/~ich/classes/mumt306/StandardMIDIfileformat.html
68*f57efe95SChristos Margiolis.Re
69*f57efe95SChristos Margiolis.Rs
70*f57efe95SChristos Margiolis.%T MIDI CC List for Continuous Controllers
71*f57efe95SChristos Margiolis.%U https://anotherproducer.com/online-tools-for-musicians/midi-cc-list/
72*f57efe95SChristos Margiolis.Re
73*f57efe95SChristos Margiolis.Sh AUTHORS
74*f57efe95SChristos MargiolisThe
75*f57efe95SChristos Margiolis.Nm
76*f57efe95SChristos Margiolisutility was implemented by
77*f57efe95SChristos Margiolis.An Christos Margiolis Aq Mt christos@FreeBSD.org
78*f57efe95SChristos Margiolisunder sponsorship from the
79*f57efe95SChristos Margiolis.Fx
80*f57efe95SChristos MargiolisFoundation.
81