aconnect(1)

✨ aconnect(1) — General Commands Manual 🎀

Okay bestie, the manual name is aconnect(1) and it's giving ALSA sequencer connection manager 💖 Let me walk you through it, no cap 💅

🦋 NAME

aconnect — ALSA sequencer connection manager 🧚

💜 SYNOPSIS

aconnect [-d] [-options] sender receiver
aconnect -i|-o [-options]
aconnect -x

🌸 DESCRIPTION

okay so aconnect is a utility for connecting and disconnecting two existing ports on the ALSA sequencer system 🔥 Ports with the arbitrary subscription permission, like the ones made by aseqview(1), can be hooked up to any (MIDI) device ports using aconnect 💖 For example, to connect from port 64:0 to 65:0, you run this:

% aconnect 64:0 65:0

The connection is one-way, so all the data going to the sender port (64:0) gets redirected to the receiver port (65:0) ✨ When another port (e.g. 65:1) is attached to the same sender port, the data goes to both receiver ports 👑 To disconnect, use the -d option 💅

% aconnect -d 64:0 65:0

You can also use the client's name instead of the address 🫶

% aconnect External:0 Emu8000:1

Then port 0 of the client matching the string "External" gets connected to port 1 of the client matching "Emu8000" 🎀

Another thing aconnect can do is list the ports that are around, based on the condition you give it 🌈 The input ports (the ones that may become sender ports) get listed with the -i option 🦋

% aconnect -i
client 0: 'System' [type=kernel]
    0 'Timer           '
    1 'Announce        '
client 64: 'External MIDI-0' [type=kernel]
    0 'MIDI 0-0        '

Similarly, to see the output ports, use the -o flag 💜

You can remove all existing exported connections with the -x option 🧹 This is super useful for shutting down the ALSA drivers, because modules with sequencer connections cannot be unloaded unless those connections are removed first 😭

✨ OPTIONS ✨

💖 CONNECTION MANAGEMENT

• -d, --disconnect — Disconnects the given subscription 💔
• -e, --exclusive — Connects ports in exclusive mode. Both the sender and receiver ports can't be connected by any other ports anymore 🔒
• -r, --real queue — Converts the time-stamps of event packets to the current value of the given real-time queue. Lowkey not super useful, though, since the receiver port has to use (not necessarily own) the specified queue 🙈
• -t, --tick queue — Like -r, but the time-stamps get converted to the current value of the given tick queue 🦋

🌸 LIST PORTS

• -i, --input — Lists the existing input (readable) ports. This is exclusive to -o 🧚
• -o, --output — Lists the existing output (writable) ports. This is exclusive to -i 🧚
• -a, --all — Lists inactive ports too 👀
• -l, --list — Lists the current connection status. The connected and connecting ports from/to each port get listed together. The suffix flag [ex] means the connection is exclusive, and the suffix flags [real:#] and [tick:#] mean the connection includes real-time or tick conversion on the listed queue, respectively 💅

🧹 REMOVE ALL CONNECTIONS

• -x, --removeall — Removes all exported connections 🫧

🦋 SEE ALSO

aseqnet(1), aseqview(1) 🔗

💜 AUTHOR

Takashi Iwai <tiwai@suse.de> 👑

Bye bestie, this manual page was brought to you by aconnect(1) 🌈 Last updated August 31, 2000 🍓 Stay iconic, stay connected 💖