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

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