ASEQSEND(1)

💖 aseqsend — the manual page, but make it cute 💖

okay bestie, welcome to aseqsend(1) from the General Commands Manual section — yes she's a real manpage, and yes she's about to be your new fave. 🎀

✨ NAME ✨

aseqsend — send arbitrary messages to a selected ALSA MIDI sequencer port. that's it, that's the whole vibe. sending whatever you want, wherever you want. 💅

🌸 SYNOPSIS 🌸

aseqsend -p client:port -s file-name
aseqsend -p client:port "hex encoded byte-string"

🦋 DESCRIPTION 🦋

so like. aseqsend is a command-line utility, and what she does is let you send SysEx (system exclusive) data to an ALSA MIDI sequencer port. and honestly? not just SysEx — she can send any other MIDI commands too. versatile queen. 👑

the messages you wanna send can come in two ways, and you pick:

• as a hex encoded byte string, given as the last argument
• or read from a raw binary file

and here's the lil detail nobody tells you: when you're sending several SysEx messages at once, there's a delay of 1ms after each message by default. want a different delay? that's what the -i option is for. set it to whatever you need. ✨

now, specifying your target. a client can be specified by:

• its number
• its name
• or a prefix of its name

a port is specified by its number. and for port 0 of a client, the ":0" part of the port specification can be omitted. so convenient. 🫶

also!! aseqsend can send UMP packets as a MIDI 2.0 device, and you do that by specifying the -u option. meanwhile the default operation is the legacy MIDI 1.0 byte stream. glow up available on request, basically. 🌈

🎀 OPTIONS 🎀

• -h, --help — prints a list of options. the classic. your bestie when you forget everything. 🙈
• -V, --version — prints the current version. receipts, but for software. 💜
• -l, --list — prints a list of possible output ports. go window shopping for ports first. 🍓
• -v, --verbose — prints the number of bytes actually sent. she'll tell you exactly what went out. no cap.
• -p, --port=client:port — target port, by number or by name. the main character of this whole operation.
• -s, --file=filename — send raw binary data from the given file name. file girlies rise. 🧚
• -i, --interval=msec — interval between SysEx messages, in milliseconds. control the pacing, control the timeline. ⏳
• -u, --ump=version — specify the MIDI version.
  • 0 for the legacy MIDI 1.0 (this is the default)
  • 1 for the UMP MIDI 1.0 protocol
  • 2 for the UMP MIDI 2.0 protocol

and okay important: when UMP MIDI 1.0 or MIDI 2.0 protocol is specified, aseqsend reads the input as raw UMP packets, 4 each byte in big endian. write that down bestie. 📝

⭐ EXAMPLES ⭐

she ate with these, honestly:

aseqsend -p 128:0 "F0 41 10 00 00 64 12 18 00 21 06 59 41 59 4E F7"

aseqsend -p 128:0 -s I7BulkDump.syx

💀 SEE ALSO 💀

• aseqdump(1) — the other half of the duo. one sends, one dumps. iconic pairing, iykyk. 👑

💖 AUTHOR 💖

Miroslav Kovac <mixxoo@gmail.com> — thank you for this gift, we are obsessed. 🫶

and that's a wrap on aseqsend(1)! this page lives in the General Commands Manual, and the version she's repping is dated 11 Mar 2024 — aseqsend(1), periodt. go send some messages, bestie. slay. 💅✨🎀