---
name: "aconnect"
section: "1"
platform: "linux"
package: "alsa-utils"
version: "1.2.16-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/aconnect"
---

# aconnect(1)

ALSA sequencer connection manager

## NAME

aconnect - ALSA sequencer connection manager

## SYNOPSIS

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

## 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),** 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

### CONNECTION MANAGEMENT

- **-d, --disconnect**

  Disconnect the given subscription.

- **-e, --exclusive**

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

- **-r, --real queue**

  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**

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

### LIST PORTS

- **-i, --input**

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

- **-o, --output**

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

- **-a, --all**

  List inactive ports, too.

- **-l, --list**

  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

- **-x, --removeall**

  Remove all exported connections.

## SEE ALSO

[aseqnet(1)](/aseqnet/1.md), aseqview(1)

## AUTHOR

Takashi Iwai \<tiwai@suse.de\>