BLUETOOTHCTL-PLAYER(1)

📦
version 5.87+2.git8750129efca8 · 9 versions
, in centos-stream 9

💖 bluetoothctl-player 💖

okay so this is the Media Player Submenu of bluetoothctl, straight out of the Linux System Administration section of the manual. it's the little corner of bluetoothctl where you control media playback, and it does that through the org.bluez.MediaPlayer(5) interface. yes bestie, D-Bus, we love her. 🎀

✨ NAME ✨

bluetoothctl-player — the Media Player Submenu, your personal aux-cord main character moment. 🎧

🌸 SYNOPSIS 🌸

bluetoothctl [--options] [player.commands]

real talk: this submenu is the one that controls media playback using the org.bluez.MediaPlayer(5) interface. that's the whole vibe. 💅

🦋 MEDIA PLAYER COMMANDS 🦋

⭐ list

Lists all the available players. that's it, that's the tweet.

Usage

> list

Example — display all available media players (local and remote, both of them, no crumbs):

> list

⭐ show

Shows you the player information. nosy in a cute way. 👀

Usage

> show [player]

Uses the org.bluez.MediaPlayer(5) properties.

  • [player] — the media player path or identifier. it's optional, and if you omit it, it shows the currently selected player. lowkey convenient.

Example — show info for the currently selected player:

> show

Example — show remote player information:

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

⭐ select

Picks the default player. choose your fighter. 👑

Usage

> select <player>
  • <player> — the media player path or identifier you want to select as default.

Example — select a remote Bluetooth media player:

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

⭐ play

Starts playback. press play, the vibes begin. ▶️

Usage

> play [item]

Uses the org.bluez.MediaPlayer(5) method Play.

  • [item] — media item path to play. optional; if you leave it out it starts playback of the current item.

Example — start playback on the current player:

> play

Example — play a specific item from the media browser:

> play /org/bluez/item/1

Example — play a named track item:

> play /org/bluez/item/track_001

Example — play a track from a specific album folder:

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

⭐ pause

Pauses playback. sometimes we need a lil breather, and that's valid. 😌

Usage

> pause

Uses the org.bluez.MediaPlayer(5) method Pause.

Example — pause the current playback:

> pause

⭐ stop

Stops playback. full stop, no notes. 🛑

Usage

> stop

Uses the org.bluez.MediaPlayer(5) method Stop.

Example — stop the current playback:

> stop

⭐ next

Jumps to the next item. skip, queen. ⏭️

Usage

> next

Uses the org.bluez.MediaPlayer(5) method Next.

Example — skip to the next track:

> next

⭐ previous

Jumps back to the previous item. we're feeling nostalgic. ⏮️

Usage

> previous

Uses the org.bluez.MediaPlayer(5) method Previous.

Example — go back to the previous track:

> previous

⭐ fast-forward

Fast forwards playback. zoom zoom. ⏩

Usage

> fast-forward

Uses the org.bluez.MediaPlayer(5) method FastForward.

Example — enable fast forward mode:

> fast-forward

⭐ rewind

Rewinds playback. rewind time, iconic behaviour honestly. ⏪

Usage

> rewind

Uses the org.bluez.MediaPlayer(5) method Rewind.

Example — enable rewind mode:

> rewind

⭐ equalizer

Enables or disables the equalizer. bass go brrr. 🎚️

Usage

> equalizer <on/off>

Uses the org.bluez.MediaPlayer(5) property Equalizer.

  • <on/off> — enable (on) or disable (off) the equalizer.

Example — enable the equalizer:

> equalizer on

Example — disable the equalizer:

> equalizer off

⭐ repeat

Sets the repeat mode. run it back. 🔁

Usage

> repeat <singletrack/alltrack/group/off>

Uses the org.bluez.MediaPlayer(5) property Repeat.

  • <singletrack/alltrack/group/off> — set the repeat mode:
    • singletrack — the current track
    • alltrack — all the tracks
    • group — the current group/album
    • off — no repeat

Example — disable repeat mode:

> repeat off

Example — repeat the current track:

> repeat singletrack

Example — repeat the entire playlist/queue:

> repeat alltrack

Example — repeat the current group/album:

> repeat group

⭐ shuffle

Sets the shuffle mode. chaos, but make it curated. 🔀

Usage

> shuffle <alltracks/group/off>

Uses the org.bluez.MediaPlayer(5) property Shuffle.

  • <alltracks/group/off> — set the shuffle mode:
    • alltracks — shuffle all tracks
    • group — shuffle within the current group
    • off — no shuffle

Example — disable shuffle mode:

> shuffle off

Example — shuffle all tracks in the playlist:

> shuffle alltracks

Example — shuffle tracks within the current group:

> shuffle group

⭐ scan

Sets the scan mode. speedrun through your library. 📡

Usage

> scan <alltracks/group/off>

Uses the org.bluez.MediaPlayer(5) property Scan.

  • <alltracks/group/off> — set the scan mode:
    • alltracks — scan through all tracks
    • group — scan within the current group
    • off — no scan

Example — disable scan mode:

> scan off

Example — scan through all tracks:

> scan alltracks

Example — scan through the current group only:

> scan group

⭐ change-folder

Changes the current folder. little navigation moment. 📁

Usage

> change-folder <item>
  • <item> — folder path to navigate to, or .. to go up one directory level. yes, it's the same .. as the shell, we been knew.

Example — navigate to the Albums folder:

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

Example — navigate to the Artists folder:

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

Example — navigate to the Playlists folder:

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

Example — go up one directory level:

> change-folder ..

⭐ list-items

Lists the items of the current folder. window shopping. 🛍️

Usage

> list-items [start] [end]
  • [start] — starting index for the item list. optional, defaults to 0.
  • [end] — ending index for the item list. optional; if you omit it, it lists all items from start.

Example — list all items in the current folder:

> list-items

Example — list the 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 the first 50 items:

> list-items 0 50

Searches for items containing a string. detective era. 🔍

Usage

> search <string>
  • <string> — the 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

Adds an item to the playlist queue. lining them up, no skips. 📋

Usage

> queue <item>
  • <item> — media item path to add to the playback queue.

Example — add a specific track to the queue:

> queue /org/bluez/item/track_001

Example — add an entire album to the queue:

> queue /org/bluez/item/album_rock

Example — add a playlist to the queue:

> queue /org/bluez/item/playlist_favorites

⭐ show-item

Shows item information. the full lore drop. 📖

Usage

> show-item <item>
  • <item> — media item path to display detailed information for.

Example — show details of a specific track:

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

Example — show details of an album:

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

Example — show details of an artist:

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

🌈 RESOURCES 🌈

http://www.bluez.org — go forth and read, bestie. ✨

🙈 REPORTING BUGS 🙈

linux-bluetooth@vger.kernel.org — tell them, don't suffer in silence. 💌

free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL). slay, legally. 💜

okay that's the whole page!! 🫶 this beauty is from BlueZ, dated November 2022, and it lives in the Linux System Administration part of the manual. go control some playback, you got this. 💖🎀🦋

📦 where this page comes from