aconnect(1) General Commands Manual aconnect(1)

# [NAME](#NAME)

aconnect - ALSA sequencer connection manager

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

**aconnect** is a utility to connect and disconnect two existing ports on ALSA sequencer system. The ports with the arbitrary subscription permission, such as created by **[aseqview(1)](/man/enterprise-packages/alsa-utils/aseqview.1),** can be connected to any (MIDI) device ports using **aconnect.** For example, to connect from port 64:0 to 65:0, run as follows:

% aconnect 64:0 65:0

The connection is one-way, and the whole data to the sender port (64:0) is redirected to the receiver port (65:0). When another port (e.g. 65:1) is attached to the same sender port, the data is sent to both receiver ports. For disconnection, use **-d** option.

```
% aconnect -d 64:0 65:0
```

The address can be given using the client's name.

```
% aconnect External:0 Emu8000:1
```

Then the port 0 of the client matching with the string "External" is connected to the port 1 of the client matching with the "Emu8000".

Another function of **aconnect** is to list the present ports on the given condition. The input ports, which may become *sender* ports, can be listed with **-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 **-o** flag.

You can remove all existing exported connections using **-x** option. This function is useful for terminating the ALSA drivers, because the modules with sequencer connections cannot be unloaded unless their connections are removed.

# [OPTIONS](#OPTIONS)

## [CONNECTION MANAGEMENT](#CONNECTION_MANAGEMENT)

[**-d, --disconnect**](#d,)

Disconnect the given subscription.

[**-e, --exclusive**](#e,)

Connect ports with exclusive mode. Both sender and receiver ports can be no longer connected by any other ports.

[**-r, --real queue**](#r,)

Convert time-stamps of event packets to the current value of the given *real-time* queue. This is option is, however, not so useful, since the receiver port must use (not necessarily own) the specified queue.

[**-t, --tick queue**](#t,)

Like **-r** option, but time-stamps are converted to the current value of the given *tick* queue.

## [LIST PORTS](#LIST_PORTS)

[**-i, --input**](#i,)

List existing input (readable) ports. This option is exclusive to **-o.**

[**-o, --output**](#o,)

List existing output (writable) ports. This option is exclusive to **-i.**

[**-a, --all**](#a,)

List inactive ports, too.

[**-l, --list**](#l,)

List the current connection status. The connected and connecting ports from/to each port are listed together. The suffix flag **\[ex]** means the connection is exclusive. The suffix flag **\[real:#]** and **\[tick:#]** mean the connection includes real-time and tick conversion on the listed queue, respectively.

## [REMOVE ALL CONNECTIONS](#REMOVE_ALL_CONNECTIONS)

[**-x, --removeall**](#x,)

Remove all exported connections.

# [SEE ALSO](#SEE_ALSO)

[aseqnet(1)](/man/enterprise-packages/alsa-utils/aseqnet.1), [aseqview(1)](/man/enterprise-packages/alsa-utils/aseqview.1)

# [AUTHOR](#AUTHOR)

Takashi Iwai <tiwai@suse.de>

August 31, 2000

---

Document: aconnect(1) from alsa-utils 1.2.16-r3 (Chainguard OS)
Source: https://github.com/alsa-project/alsa-utils