bluetoothctl-player(1) Linux System Administration bluetoothctl-player(1)

bluetoothctl-player - Media Player Submenu

bluetoothctl [--options] [player.commands]

This submenu controls media playback using the org.bluez.MediaPlayer(5) interface.

List available players.

> list
> list

Show player information.

> show [player]
org.bluez.MediaPlayer(5) properties
[player]
Media player path or identifier (optional, shows currently selected player if omitted)
> show
> show /org/bluez/hci0/dev_00_11_22_33_44_55/player0

Select default player.

> select <player>
<player>
Media player path or identifier to select as default
> select /org/bluez/hci0/dev_00_11_22_33_44_55/player0

Start playback.

> play [item]
org.bluez.MediaPlayer(5) method Play
[item]
Media item path to play (optional, starts playback of current item if omitted)
> play
> play /org/bluez/item/1
> play /org/bluez/item/track_001
> play /org/bluez/item/album_rock/track_05

Pause playback.

> pause
org.bluez.MediaPlayer(5) method Pause
> pause

Stop playback.

> stop
org.bluez.MediaPlayer(5) method Stop
> stop

Jump to next item.

> next
org.bluez.MediaPlayer(5) method Next
> next

Jump to previous item.

> previous
org.bluez.MediaPlayer(5) method Previous
> previous

Fast forward playback.

> fast-forward
org.bluez.MediaPlayer(5) method FastForward
> fast-forward

Rewind playback.

> rewind
org.bluez.MediaPlayer(5) method Rewind
> rewind

Enable/Disable equalizer.

> equalizer <on/off>
org.bluez.MediaPlayer(5) property Equalizer
<on/off>
Enable (on) or disable (off) the equalizer
> equalizer on
> equalizer off

Set repeat mode.

> repeat <singletrack/alltrack/group/off>
org.bluez.MediaPlayer(5) property Repeat
<singletrack/alltrack/group/off>
Set repeat mode - singletrack (current track), alltrack (all tracks), group (current group/album), or off (no repeat)
> repeat off
> repeat singletrack
> repeat alltrack
> repeat group

Set shuffle mode.

> shuffle <alltracks/group/off>
org.bluez.MediaPlayer(5) property Shuffle
<alltracks/group/off>
Set shuffle mode - alltracks (shuffle all tracks), group (shuffle within current group), or off (no shuffle)
> shuffle off
> shuffle alltracks
> shuffle group

Set scan mode.

> scan <alltracks/group/off>
org.bluez.MediaPlayer(5) property Scan
<alltracks/group/off>
Set scan mode - alltracks (scan through all tracks), group (scan within current group), or off (no scan)
> scan off
> scan alltracks
> scan group

Change current folder.

> change-folder <item>
<item>
Folder path to navigate to, or ".." to go up one directory level
> change-folder /org/bluez/item/Albums
> change-folder /org/bluez/item/Artists
> change-folder /org/bluez/item/Playlists
> change-folder ..

list-items

List items of current folder.

> list-items [start] [end]
[start]
Starting index for item list (optional, defaults to 0)
[end]
Ending index for item list (optional, lists all items from start if omitted)
> list-items
> list-items 0 10
> list-items 5 15
> list-items 10 20
> list-items 0 50

Search items containing string.

> search <string>
<string>
Search term to find matching items (songs, albums, artists, etc.)
> search "The Beatles"
> search "rock"
> search "2023"
> search "playlist"

Add item to playlist queue.

> queue <item>
<item>
Media item path to add to the playback queue
> queue /org/bluez/item/track_001
> queue /org/bluez/item/album_rock
> queue /org/bluez/item/playlist_favorites

show-item

Show item information.

> show-item <item>
<item>
Media item path to display detailed information for
> show-item /org/bluez/item/track_001
> show-item /org/bluez/item/album_rock
> show-item /org/bluez/item/artist_beatles

http://www.bluez.org

<linux-bluetooth@vger.kernel.org>

Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL).

November 2022 BlueZ