MPRIS-CTL(1)

💖 MPRIS-CTL(1) 💖

okay so bestie, welcome to the mpris-ctl page from the General Commands Manual — yes that's the manual name, she's official, she's got a whole section header and everything ✨

---

🌸 NAME 🌸

mpris-ctl — a whole control utility for media players, like literally the remote control for your music but make it terminal 💅

---

🦋 SYNOPSIS 🦋

mpris-ctl [OPTIONS...] [COMMAND] [format string]

that's the whole vibe, that's the shape of it, no notes 🫶

---

✨ DESCRIPTION ✨

So mpris-ctl is a control utility for any media-player that conforms to the MPRIS D-Bus Interface Specification[1]. Any of them. All of them. Your player just has to speak MPRIS and she's in 👑

---

🎀 OPTIONS 🎀

• --player active | inactive | <name,...> — tells the command which players it should be addressed to, like picking who's in the group chat. The valid values are:
  • active — all players that are currently in Playing state. the main characters rn 🔥
  • inactive — all players that are currently in Stopped or Paused state. the ones on a lil break 😴
  • <name...> — specific player names, separated by spaces. yes, spaces. not commas. spaces 💀

If the option is absent we consider all the players, active and inactive. everyone's invited, no cap 🌈

---

💜 COMMANDS 💜

• help — this help message. hi, you found her 🫶
• play — begin playing. press play bestie ▶️
• pp — toggle play or pause. the chaotic one, the indecisive icon 🎭
• pause — pause the player. hold that thought ✋
• stop — stop the player. full stop, periodt 🛑
• next — change to the next track play-list. skip, skip, slay ⏭️
• prev — change to the previous track in the play-list. go back, we miss her ⏮️
• status — get the playback status. equivalent to the info %play_status action, iykyk
• list — get the name of the running player(s). equivalent to the info %player_name action, literally the same thing ✨
• info [format string] — print information about the current track. and format string can include any of the following FORMAT SPECIFIERS, which is the next section, keep scrolling babe 💖

---

🧚 FORMAT SPECIFIERS 🧚

• %player_name — prints the media-player's name
• %track_name — prints the track's name
• %track_number — prints the track number
• %track_length — prints the track length in seconds
• %artist_name — prints the artist's name
• %album_name — prints the album's name
• %album_artist — prints the album's artist
• %art_url — prints the URL of the cover art image
• %play_status — prints the playback status
• %shuffle — prints the shuffle mode
• %volume — prints the volume level
• %loop_status — prints the loop status
• %position — prints the track's position in seconds
• %bitrate — prints the track's bit-rate
• %comment — prints the track's comment
• %full — prints all available information. the whole lore drop, the entire iceberg 👑

---

⭐ EXAMPLE ⭐

mpris-ctl info %full

and she gives you:

Player name:   Spotify
Play status:   Playing
Track:         Song 2
Artist:        Blur
Album:         Blur: The Best Of
Album Artist:  Blur
Art URL:       https://open.spotify.com/image/7731a6d23ed9f82ea94e89b248450eb00f044a1b
Track:         2
Length:        121.88s
Volume:        0.00
Loop status:   None
Shuffle:       false
Position:      0.00s
Bitrate:       0
Comment:

not the Comment: being empty 😭 relatable honestly

---

🌸 NOTES 🌸

1. MPRIS D-Bus Interface Specification https://specifications.freedesktop.org/mpris-spec/latest/

go read the spec bestie, it's giving documentation 💅

---

aaaand that's the page 🎀 this cutie dropped on 2022-12-04, part of the General Commands Manual, and her name is mpris-ctl(1) — go control some media, you got this 💖🦋✨