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

# [Name](#Name)

bluetoothctl-player - Media Player Submenu

# [SYNOPSIS](#SYNOPSIS)

**bluetoothctl** \[--options] \[player.commands]

This submenu controls media playback using the [**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) interface.

# [Media Player Commands](#Media_Player_Commands)

## [list](#list)

List available players.

[**Usage**](#Usage)

**> list**

[**Example Display all available media players (local and remote)**](#Example)

```
> list
```

## [show](#show)

Show player information.

[**Usage**](#Usage~2)

**> show \[player]**

[**Uses**](#Uses)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) properties

**\[player]**

Media player path or identifier (optional, shows currently selected player if omitted)

[**Example Show information for currently selected player**](#Example~2)

```
> show
```

[**Example Show remote player information**](#Example~3)

```
> show /org/bluez/hci0/dev_00_11_22_33_44_55/player0
```

## [select](#select)

Select default player.

[**Usage**](#Usage~3)

**> select <player>**

**<player>**

Media player path or identifier to select as default

[**Example Select remote Bluetooth media player**](#Example~4)

```
> select /org/bluez/hci0/dev_00_11_22_33_44_55/player0
```

## [play](#play)

Start playback.

[**Usage**](#Usage~4)

**> play \[item]**

[**Uses**](#Uses~2)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) method **Play**

**\[item]**

Media item path to play (optional, starts playback of current item if omitted)

[**Example Start playback on current player**](#Example~5)

```
> play
```

[**Example Play specific item from media browser**](#Example~6)

```
> play /org/bluez/item/1
```

[**Example Play named track item**](#Example~7)

```
> play /org/bluez/item/track_001
```

[**Example Play track from specific album folder**](#Example~8)

```
> play /org/bluez/item/album_rock/track_05
```

## [pause](#pause)

Pause playback.

[**Usage**](#Usage~5)

**> pause**

[**Uses**](#Uses~3)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) method **Pause**

[**Example Pause current playback**](#Example~9)

```
> pause
```

## [stop](#stop)

Stop playback.

[**Usage**](#Usage~6)

**> stop**

[**Uses**](#Uses~4)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) method **Stop**

[**Example Stop current playback**](#Example~10)

```
> stop
```

## [next](#next)

Jump to next item.

[**Usage**](#Usage~7)

**> next**

[**Uses**](#Uses~5)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) method **Next**

[**Example Skip to next track**](#Example~11)

```
> next
```

## [previous](#previous)

Jump to previous item.

[**Usage**](#Usage~8)

**> previous**

[**Uses**](#Uses~6)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) method **Previous**

[**Example Go back to previous track**](#Example~12)

```
> previous
```

## [fast-forward](#fast)

Fast forward playback.

[**Usage**](#Usage~9)

**> fast-forward**

[**Uses**](#Uses~7)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) method **FastForward**

[**Example Enable fast forward mode**](#Example~13)

```
> fast-forward
```

## [rewind](#rewind)

Rewind playback.

[**Usage**](#Usage~10)

**> rewind**

[**Uses**](#Uses~8)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) method **Rewind**

[**Example Enable rewind mode**](#Example~14)

```
> rewind
```

## [equalizer](#equalizer)

Enable/Disable equalizer.

[**Usage**](#Usage~11)

**> equalizer <on/off>**

[**Uses**](#Uses~9)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/org.bluez.MediaPlayer.5) property **Equalizer**

**<on/off>**

Enable (on) or disable (off) the equalizer

[**Example Enable equalizer**](#Example~15)

```
> equalizer on
```

[**Example Disable equalizer**](#Example~16)

```
> equalizer off
```

## [repeat](#repeat)

Set repeat mode.

[**Usage**](#Usage~12)

**> repeat <singletrack/alltrack/group/off>**

[**Uses**](#Uses~10)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/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)

[**Example Disable repeat mode**](#Example~17)

```
> repeat off
```

[**Example Repeat current track**](#Example~18)

```
> repeat singletrack
```

[**Example Repeat entire playlist/queue**](#Example~19)

```
> repeat alltrack
```

[**Example Repeat current group/album**](#Example~20)

```
> repeat group
```

## [shuffle](#shuffle)

Set shuffle mode.

[**Usage**](#Usage~13)

**> shuffle <alltracks/group/off>**

[**Uses**](#Uses~11)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/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)

[**Example Disable shuffle mode**](#Example~21)

```
> shuffle off
```

[**Example Shuffle all tracks in playlist**](#Example~22)

```
> shuffle alltracks
```

[**Example Shuffle tracks within current group**](#Example~23)

```
> shuffle group
```

## [scan](#scan)

Set scan mode.

[**Usage**](#Usage~14)

**> scan <alltracks/group/off>**

[**Uses**](#Uses~12)

[**org.bluez.MediaPlayer(5)**](/man/os/bluez/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)

[**Example Disable scan mode**](#Example~24)

```
> scan off
```

[**Example Scan through all tracks**](#Example~25)

```
> scan alltracks
```

[**Example Scan through current group only**](#Example~26)

```
> scan group
```

## [change-folder](#change)

Change current folder.

[**Usage**](#Usage~15)

**> change-folder <item>**

**<item>**

Folder path to navigate to, or ".." to go up one directory level

[**Example Navigate to Albums folder**](#Example~27)

```
> change-folder /org/bluez/item/Albums
```

[**Example Navigate to Artists folder**](#Example~28)

```
> change-folder /org/bluez/item/Artists
```

[**Example Navigate to Playlists folder**](#Example~29)

```
> change-folder /org/bluez/item/Playlists
```

[**Example Go up one directory level**](#Example~30)

```
> change-folder ..
```

## list-items

List items of current folder.

[**Usage**](#Usage~16)

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

[**Example List all items in current folder**](#Example~31)

```
> list-items
```

[**Example List first 10 items (0-10)**](#Example~32)

```
> list-items 0 10
```

[**Example List items 5 through 15**](#Example~33)

```
> list-items 5 15
```

[**Example List items 10 through 20**](#Example~34)

```
> list-items 10 20
```

[**Example List first 50 items**](#Example~35)

```
> list-items 0 50
```

## [search](#search)

Search items containing string.

[**Usage**](#Usage~17)

**> search <string>**

**<string>**

Search term to find matching items (songs, albums, artists, etc.)

[**Example Search for Beatles songs/albums**](#Example~36)

```
> search "The Beatles"
```

[**Example Search for items containing "rock"**](#Example~37)

```
> search "rock"
```

[**Example Search for items from 2023**](#Example~38)

```
> search "2023"
```

[**Example Search for playlists**](#Example~39)

```
> search "playlist"
```

## [queue](#queue)

Add item to playlist queue.

[**Usage**](#Usage~18)

**> queue <item>**

**<item>**

Media item path to add to the playback queue

[**Example Add specific track to queue**](#Example~40)

```
> queue /org/bluez/item/track_001
```

[**Example Add entire album to queue**](#Example~41)

```
> queue /org/bluez/item/album_rock
```

[**Example Add playlist to queue**](#Example~42)

```
> queue /org/bluez/item/playlist_favorites
```

## show-item

Show item information.

[**Usage**](#Usage~19)

**> show-item <item>**

**<item>**

Media item path to display detailed information for

[**Example Show details of specific track**](#Example~43)

```
> show-item /org/bluez/item/track_001
```

[**Example Show details of album**](#Example~44)

```
> show-item /org/bluez/item/album_rock
```

[**Example Show details of artist**](#Example~45)

```
> show-item /org/bluez/item/artist_beatles
```

# [RESOURCES](#RESOURCES)

<http://www.bluez.org>

# [REPORTING BUGS](#REPORTING_BUGS)

<linux-bluetooth@vger.kernel.org>

# [Copyright](#Copyright)

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

November 2022 BlueZ

---

Document: bluetoothctl-player(1) from bluez 5.87-r2 (Chainguard OS)
Source: https://github.com/bluez/bluez