table of contents
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 acquire.
- 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 selected 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 audio.
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 support (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 audio 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¶
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).
November 2022 | BlueZ |