BLUETOOTHCTL-TRANSPORT(1) Linux System Administration BLUETOOTHCTL-TRANSPORT(1)
NAME
bluetoothctl-transport - Media Transport Submenu
SYNOPSIS
bluetoothctl [--options] [transport.commands]
MEDIA TRANSPORT COMMANDS
list
List available transports.
Usage > list
show
Show transport information.
Usage > show [transport]
acquire
Acquire transport.
Usage > acquire <transport> [transport1...]
Note:
If running the setup with an audio server that has LE Audio support
(such as PipeWire) it will automatically acquire transports according to
the configured roles.
select
Select transport. For transports created on a Broadcast Sink device
only. This moves the transport to the "broadcasting" state, pending ac-
quire.
Usage > select <transport> [transport1...]
Note:
If the select command receives a list of transports, they will first be
linked using the "Links" MediaTransport property. They will then be se-
lected one by one, by calling the "Select" MediaTransport method. After
the first transport is acquired, the Broadcast Sink will create fds for
the associated stream and all its links. Each link can then be acquired
one by one, setting the fd for the transport and starting to receive au-
dio.
The select command does not require a local endpoint to be registered
beforehand. This is because if the setup runs with an audio server that
has LE Audio support (such as PipeWire), the audio server is the one to
register endpoints and the transports are created as a result. Once a
transport is selected, the audio server will automatically acquire.
unselect
Unselect transport. For transports created on a Broadcast Sink device
only. This moves the transport to the "idle" state, pending release by
the audio server. If the transport was acquired by bluetoothctl it can
be released straight away, without having to be unselected.
Usage > unselect <transport> [transport1...]
Note: If running the setup with an audio server that has LE Audio sup-
port (such as PipeWire), it will prompt it to automatically release the
transport.
release
Release transport.
Usage > release <transport> [transport1...]
Note:
Transports acquired by an audio server, can only be released by said au-
dio server.
send
Send contents of a file.
Usage > send <transport> <filename>
receive
Get/Set file to receive.
Usage > receive <transport> [filename]
volume
Get/Set transport volume.
Usage > volume <transport> [value]
RESOURCES
<http://www.bluez.org>
REPORTING BUGS
<linux-bluetooth@vger.kernel.org>
COPYRIGHT
Free use of this software is granted under the terms of the GNU Lesser
General Public Licenses (LGPL).
BlueZ November 2022 BLUETOOTHCTL-TRANSPORT(1)
Generated by dwww version 1.16 on Sat Oct 3 07:35:15 CEST 2026.