--- name: "bluetoothctl-player" section: "1" platform: "linux" package: "bluez-utils" version: "5.87-2" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/bluetoothctl-player" --- # bluetoothctl-player(1) Media Player Submenu ## Name bluetoothctl-player - Media Player Submenu ## SYNOPSIS **bluetoothctl** \[--options\] \[player.commands\] This submenu controls media playback using the **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** interface. ## Media Player Commands ### list List available players. - **Usage** **\> list** - **Example Display all available media players (local and remote)** ``` > list ``` ### show Show player information. - **Usage** **\> show \[player\]** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** properties - **\[player\]** Media player path or identifier (optional, shows currently selected player if omitted) - **Example Show information for currently selected player** ``` > show ``` - **Example Show remote player information** ``` > show /org/bluez/hci0/dev_00_11_22_33_44_55/player0 ``` ### select Select default player. - **Usage** **\> select \** - **\** Media player path or identifier to select as default - **Example Select remote Bluetooth media player** ``` > select /org/bluez/hci0/dev_00_11_22_33_44_55/player0 ``` ### play Start playback. - **Usage** **\> play \[item\]** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** method **Play** - **\[item\]** Media item path to play (optional, starts playback of current item if omitted) - **Example Start playback on current player** ``` > play ``` - **Example Play specific item from media browser** ``` > play /org/bluez/item/1 ``` - **Example Play named track item** ``` > play /org/bluez/item/track_001 ``` - **Example Play track from specific album folder** ``` > play /org/bluez/item/album_rock/track_05 ``` ### pause Pause playback. - **Usage** **\> pause** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** method **Pause** - **Example Pause current playback** ``` > pause ``` ### stop Stop playback. - **Usage** **\> stop** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** method **Stop** - **Example Stop current playback** ``` > stop ``` ### next Jump to next item. - **Usage** **\> next** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** method **Next** - **Example Skip to next track** ``` > next ``` ### previous Jump to previous item. - **Usage** **\> previous** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** method **Previous** - **Example Go back to previous track** ``` > previous ``` ### fast-forward Fast forward playback. - **Usage** **\> fast-forward** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** method **FastForward** - **Example Enable fast forward mode** ``` > fast-forward ``` ### rewind Rewind playback. - **Usage** **\> rewind** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** method **Rewind** - **Example Enable rewind mode** ``` > rewind ``` ### equalizer Enable/Disable equalizer. - **Usage** **\> equalizer \** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** property **Equalizer** - **\** Enable (on) or disable (off) the equalizer - **Example Enable equalizer** ``` > equalizer on ``` - **Example Disable equalizer** ``` > equalizer off ``` ### repeat Set repeat mode. - **Usage** **\> repeat \** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** property **Repeat** - **\** Set repeat mode - singletrack (current track), alltrack (all tracks), group (current group/album), or off (no repeat) - **Example Disable repeat mode** ``` > repeat off ``` - **Example Repeat current track** ``` > repeat singletrack ``` - **Example Repeat entire playlist/queue** ``` > repeat alltrack ``` - **Example Repeat current group/album** ``` > repeat group ``` ### shuffle Set shuffle mode. - **Usage** **\> shuffle \** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** property **Shuffle** - **\** Set shuffle mode - alltracks (shuffle all tracks), group (shuffle within current group), or off (no shuffle) - **Example Disable shuffle mode** ``` > shuffle off ``` - **Example Shuffle all tracks in playlist** ``` > shuffle alltracks ``` - **Example Shuffle tracks within current group** ``` > shuffle group ``` ### scan Set scan mode. - **Usage** **\> scan \** - **Uses** **[org.bluez.MediaPlayer(5)](/org.bluez.MediaPlayer/5.md)** property **Scan** - **\** Set scan mode - alltracks (scan through all tracks), group (scan within current group), or off (no scan) - **Example Disable scan mode** ``` > scan off ``` - **Example Scan through all tracks** ``` > scan alltracks ``` - **Example Scan through current group only** ``` > scan group ``` ### change-folder Change current folder. - **Usage** **\> change-folder \** - **\** Folder path to navigate to, or ".." to go up one directory level - **Example Navigate to Albums folder** ``` > change-folder /org/bluez/item/Albums ``` - **Example Navigate to Artists folder** ``` > change-folder /org/bluez/item/Artists ``` - **Example Navigate to Playlists folder** ``` > change-folder /org/bluez/item/Playlists ``` - **Example Go up one directory level** ``` > change-folder .. ``` ### list-items List items of current folder. - **Usage** **\> 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** ``` > list-items ``` - **Example List first 10 items (0-10)** ``` > list-items 0 10 ``` - **Example List items 5 through 15** ``` > list-items 5 15 ``` - **Example List items 10 through 20** ``` > list-items 10 20 ``` - **Example List first 50 items** ``` > list-items 0 50 ``` ### search Search items containing string. - **Usage** **\> search \** - **\** Search term to find matching items (songs, albums, artists, etc.) - **Example Search for Beatles songs/albums** ``` > search "The Beatles" ``` - **Example Search for items containing "rock"** ``` > search "rock" ``` - **Example Search for items from 2023** ``` > search "2023" ``` - **Example Search for playlists** ``` > search "playlist" ``` ### queue Add item to playlist queue. - **Usage** **\> queue \** - **\** Media item path to add to the playback queue - **Example Add specific track to queue** ``` > queue /org/bluez/item/track_001 ``` - **Example Add entire album to queue** ``` > queue /org/bluez/item/album_rock ``` - **Example Add playlist to queue** ``` > queue /org/bluez/item/playlist_favorites ``` ### show-item Show item information. - **Usage** **\> show-item \** - **\** Media item path to display detailed information for - **Example Show details of specific track** ``` > show-item /org/bluez/item/track_001 ``` - **Example Show details of album** ``` > show-item /org/bluez/item/album_rock ``` - **Example Show details of artist** ``` > show-item /org/bluez/item/artist_beatles ``` ## RESOURCES \ ## REPORTING BUGS \ ## Copyright Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL).