ARECORDMIDI2(1)

✨ ARECORDMIDI2 ✨

okay bestie, gather round, because this is the manual page for arecordmidi2 from the General Commands Manual and it's literally about recording a MIDI Clip file πŸ’– no cap, that's the whole vibe.


🌸 NAME 🌸

arecordmidi2 β€” record a MIDI Clip file πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

arecordmidi2 [options] midi2file

πŸ’… DESCRIPTION πŸ’…

arecordmidi2 is a command-line utility that records a MIDI Clip file from one or more ALSA sequencer ports. it's giving "tape deck but make it 2024" fr fr 🎧

to stop the recording, press Ctrl+C. that's the whole stop button, bestie, no fancy UI here 😌

when - is passed to the MIDI Clip file argument, it's recorded to stdout. and yes queen, it implies the -s option too ✨


πŸ‘‘ OPTIONS πŸ‘‘

  • -h, --help β€” prints a list of options. a little menu of possibilities, slay 🫢
  • -V, --version β€” prints the current version. gotta know which era of iconic we're in πŸ’œ
  • -p, --port=client:port,... β€” sets the sequencer port(s) from which events are recorded.

a client can be specified by its number, its name, or a prefix of its name. a port is specified by its number; for port 0 of a client, the ":0" part of the port specification can be omitted. lowkey convenient 🌈

arecordmidi2 creates a UMP Endpoint containing the same number of Function Blocks as specified by this option, each of which is connected to the specified port as a source.

when no source ports are specified with the -p option, arecordmidi2 creates a UMP Endpoint with full 16 Function Blocks and records from those inputs. the user can connect the sequencer ports freely via aconnect, for example. this mode can be used together with the interactive mode via the -r option. main character energy honestly πŸ‘‘

  • -b, --bpm=beats β€” sets the musical tempo of the MIDI file, in beats per minute. the default value is 120 BPM. a nice chill default, we love to see it 🎡
  • -t, --ticks=ticks β€” sets the resolution of timestamps (ticks) in the MIDI file, in ticks per beat. the default value is 384 ticks/beat. precision queen πŸ’…
  • -i, --timesig=numerator:denominator β€” sets the time signature for the MIDI file.

the time signature is specified as usual with two numbers, representing the numerator and denominator of the time signature as it would be notated. the denominator must be a power of two. both numbers should be separated by a colon. the time signature is 4:4 by default. math but make it musical 🧚

  • -n, --num-events=events β€” stops the recording after receiving the given number of events. it knows when to leave the party, iconic behavior ✨
  • -u, --ump=version β€” sets the UMP MIDI protocol version. either 1 or 2 has to be given for MIDI 1.0 and MIDI 2.0 protocol, respectively. default is 1. choose your fighter πŸ₯Š
  • -r, --interactive β€” run in the interactive mode. arecordmidi2 waits for a RETURN key input from the terminal to start the recording. after starting, the recording ends when another RETURN key is input from the terminal. the received events before the start of recording are discarded. so like, everything before the countdown? gone bestie, don't look at it πŸ’€
  • -s, --silent β€” don't print messages to stdout. quiet luxury πŸŒ™
  • -P, --profile=file β€” read the UMP data from the given file and put them into the configuration section of the recorded output. the file must contain only valid UMP data encoded in big-endian. no messy files allowed, only valid UMP data, periodt πŸ’―
  • --song=text β€” put the given meta data text in the configuration section.
  • --clip=text β€” put the given meta data text in the configuration section.
  • --copyright=text β€” put the given meta data text in the configuration section.
  • --composer=text β€” put the given meta data text in the configuration section.
  • --lyricist=text β€” put the given meta data text in the configuration section.
  • --arranger=text β€” put the given meta data text in the configuration section.
  • --publisher=text β€” put the given meta data text in the configuration section.
  • --performer=text β€” put the given meta data text in the configuration section.
  • --accompany=text β€” put the given meta data text in the configuration section.
  • --date=text β€” put the given meta data text in the configuration section.
  • --location=text β€” put the given meta data text in the configuration section.
all of those --song, --clip, --copyright, --composer, --lyricist, --arranger, --publisher, --performer, --accompany, --date and --location options do the same little job: they drop your given meta data text into the configuration section. credits where credits are due, bestie 🎬

πŸ”₯ SEE ALSO πŸ”₯


🫢 AUTHOR 🫢

Takashi Iwai <tiwai@suse.de> β€” the legend, the blueprint, the moment πŸ‘‘


and that's a wrap on the ARECORDMIDI2(1) page from the General Commands Manual, dated 4 July 2024 πŸ’– go forth and record, bestie, you got this 🌟