PLAYERCTL(1)                General Commands Manual               PLAYERCTL(1)

<?><?><?> (NAME)
     playerctl - <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> MPRIS

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
     playerctl [-aFhlV] [-f FORMAT] [-i NAME] [-p NAME] command

<?><?><?><?><?><?><?> (DESCRIPTION)
     <?><?><?><?><?> playerctl <?><?><?><?><?><?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
     MPRIS <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?> <?><?>
     <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
     <?> <?><?><?><?><?> playerctl <?><?><?><?><?><?> <?><?> <?><?><?><?>
     <?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?>
     <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?> <?><?><?>
     <?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.  playerctl
     <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
     (<?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
     <?><?><?><?><?>) <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
     <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

     <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
     <?><?> <?><?><?><?><?><?><?> <?><?> playerctl <?><?><?><?><?> <?><?>
     <?><?><?><?><?> <?><?><?> <?><?><?><?> audacious(1) <?> cmus(1) <?>
     mopidy(1) <?> mpd(1) <?> quodlibet(1) <?> rhythmbox(1) <?> vlc(1) <?>
     xmms2(1) <?><?><?><?><?><?><?>.  <?><?> <?><?><?> <?><?><?><?> <?><?>
     <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
     <?><?><?><?> MPRIS <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
     <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
     <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> playerctl
     <?><?><?><?><?> <?><?><?>.

     <?><?><?><?><?><?> Playerctl <?><?> <?><?><?><?><?> <?><?>
     <?><?><?><?><?> <?><?> <?><?><?> playerctld <?><?><?><?><?>
     <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
     <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?>
     playerctld <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
     <?><?><?><?><?><?><?><?> playerctl <?><?> <?><?><?>
     <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
     <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?>.  <?><?><?><?>
     <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
     playerctld daemon <?><?> <?><?><?><?> <?><?><?><?>.

     <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>:

     -a, --all-players
             <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>.

     -F, --follow
             <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?> <?><?>.

     -f FORMAT, --format FORMAT
             <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?> FORMAT.  <?><?><?> Format Strings <?><?>
             <?><?><?><?><?><?>.

     -h, --help
             <?><?><?> <?><?><?> <?><?><?><?><?><?> <?> <?><?><?>
             <?><?><?><?>.

     -i NAME, --ignore-player NAME
             <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
             <?><?><?><?> NAME.  <?><?><?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
             <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
             <?><?><?><?> <?><?><?>.

     -l, --list-all
             <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
             <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?>.

     -p NAME, --player NAME
             <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> NAME.
             <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?><?><?> <?><?><?><?> <?><?><?>.  <?><?><?><?><?><?><?>
             <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
             <?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?> "name" <?><?> <?><?>
             "name" <?> <?><?> <?><?> "name.{INSTANCE}" <?><?><?><?><?><?>
             <?><?><?><?>.  <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
             "%any" <?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?>.

     -s, --no-messages
             <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?><?>.

     -V, --version
             <?><?><?> <?><?><?><?><?> <?><?><?><?> <?> <?><?><?>
             <?><?><?><?>.

     <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>:

     status  <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?><?>.

     play    <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?>.

     pause   <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?>.

     play-pause
             <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
             <?><?><?> <?> <?><?><?>.

     stop    <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?>.

     next    <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

     previous
             <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

     position [OFFSET[+|-]]
             <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
             <?><?><?> <?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?><?><?>
             <?><?><?> OFFSET <?> <?><?><?><?><?><?> <?><?> OFFSET
             <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?> <?><?><?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> [+|-] <?><?>
             <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?><?><?><?> OFFSET <?><?><?><?><?> <?><?><?><?> <?><?>
             <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

     volume [LEVEL[+|-]]
             <?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> 0.0 (0%)
             <?><?> 1.0 (100%).  <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
             LEVEL <?> <?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?> LEVEL <?><?><?><?><?>
             <?><?><?><?><?><?>.  <?><?> <?><?><?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> [+|-] <?><?>
             <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> LEVEL
             <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

     metadata [KEY]
             <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?>
             KEY <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?> KEY <?><?><?> <?><?><?><?><?><?>.

     open URI
             <?><?><?> <?><?><?><?> URI <?><?> <?><?><?><?><?><?><?><?><?>.
             URI <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?>
             <?><?> URL <?><?><?><?><?> <?><?><?><?>.

     shuffle [On | Off | Toggle]
             <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> (shuffle)
             <?><?><?><?><?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?><?><?>
             <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
             <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
             On <?> Off <?><?> Toggle <?><?><?><?><?> <?><?><?><?><?><?>.

     loop [None | Track | Playlist]
             <?><?><?> <?><?><?><?><?> <?><?><?><?><?> (loop)
             <?><?><?><?><?><?><?><?><?>.  <?><?> <?><?><?><?> <?><?><?><?>
             <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
             <?><?><?> None (<?><?><?><?><?><?><?> <?><?><?><?>
             <?><?><?><?><?> <?>) Track (<?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?> <?>) <?><?> Playlist (<?><?><?><?><?>
             <?><?><?><?><?> <?><?><?> <?><?><?><?>) <?><?><?><?><?>
             <?><?><?><?><?><?>.  <?><?><?><?><?> <?><?><?><?><?><?><?><?>
             position <?> metadata <?> status <?> volume <?><?>
             <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
             <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
             <?><?><?>.  <?><?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
             <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>: `{{var}}'.
             <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
             <?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

             <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>
             <?><?><?><?><?><?> <?><?><?><?>:

             playerName
                     <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.

             position
                     <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?> <?><?> <?><?><?>
                     <?><?><?><?><?><?><?><?><?><?>.

             status  <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?>.

             volume  <?><?><?><?><?> <?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> 0.0
                     (0%) <?><?> 1.0 (100%).

             <?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> metadata
             <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?><?>
             <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
             <?><?><?><?> <?><?><?><?> <?><?><?>
             <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
             <?><?><?><?><?> <?><?><?><?><?>.  <?><?><?><?> <?><?><?><?><?><?>
             <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
             <?><?> <?><?><?><?><?><?> MPRIS<?> <?><?> MPRIS v2 metadata
             guidelines <?><?><?><?><?><?> <?><?><?><?>.
             <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
             <?><?><?> <?><?><?><?><?>:

             album, xesam:album
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

             artist, xesam:artist
                     <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

             title, xesam:title
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

             <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
             <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>.
             <?><?><?><?><?> <?><?> <?><?><?><?> `{{func(var)}}'
             <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?><?><?><?>
             <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>:

             lc(str)
                     <?><?><?><?><?> <?><?><?><?> str <?><?> <?><?><?><?>
                     <?><?><?><?>.

             uc(str)
                     <?><?><?><?><?> <?><?><?><?> str <?><?> <?><?><?><?>
                     <?><?><?><?>.

             markup_escape(str)
                     <?><?><?><?> <?><?><?><?> (escape)
                     <?><?><?><?><?><?><?><?><?> XML <?><?> <?><?><?><?> str.

             default(str1, str2)
                     <?><?><?> str1 <?><?> <?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?><?> <?><?><?> str2.

             duration(time)
                     <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
                     time <?><?> <?><?><?> `hh:mm:ss'.  <?><?><?><?> <?><?>
                     position <?><?> mpris:length <?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?>.

             emoji(key)
                     <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
                     key <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.
                     <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> status <?>
                     volume <?><?><?><?><?><?><?><?><?><?> <?><?><?>
                     <?><?><?>.

             trunc(str, len)
                     <?><?><?><?><?> <?><?><?><?> str <?><?>
                     <?><?><?><?><?><?> len <?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
                     (<?>) <?><?> <?><?><?><?> <?><?><?><?>.

             <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
             <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
             <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

             <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
             <?><?><?><?> <?><?><?><?> playerctl <?><?><?><?><?> <?><?>
             <?><?><?> <?><?><?><?><?> <?><?>.  <?><?><?><?><?> <?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
             <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
             <?><?><?><?><?><?>.  <?><?><?><?> <?><?> <?><?><?><?>
             <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
             <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
             <?><?>..Sh "<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)"
             The playerctl utility exits 0 on success, and >0 if an error
             occurs.

<?><?><?><?><?><?><?> (EXAMPLES)
     <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
     <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?>
     <?><?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>:

           $ playerctl metadata --format '{{playerName}}: {{lc(status)}} '\
           '{{duration(position)}}|{{duration(mpris:length)}}'

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
     MPRIS v2 metadata guidelines, freedesktop.org,
     https://freedesktop.org/wiki/Specifications/mpris-spec/metadata, 18
     <?><?><?><?><?><?><?> 2013.

     <?><?><?><?> <?><?><?><?> playerctl:
     https://github.com/altdesktop/playerctl, <?><?><?><?><?><?><?> API
     <?><?><?><?><?> playerctl: https://dubstepdish.com/playerctl,
     <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> GObject introspection:
     https://wiki.gnome.org/Projects/GObjectIntrospection/Users

<?><?><?><?><?><?><?><?><?> (AUTHORS)
     <?><?><?><?><?> playerctl <?><?><?><?> Tony Crisci <tony@dubstepdish.com>
     <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?> <?><?><?><?> GNU
     Lesser General Public License 3.0 <?><?> <?><?><?><?><?> <?><?><?><?>
     <?><?><?><?><?> <?><?><?>.

     <?><?><?> <?><?><?><?> <?><?><?><?> Nick Morrott
     <knowledgejunkie@gmail.com> <?><?><?><?> <?><?><?><?><?> Debian GNU/Linux
     <?><?><?><?><?> <?><?><?> <?><?><?>.  <?><?><?> <?><?><?><?><?><?>
     <?><?><?><?><?> <?><?><?><?> Stephen Gregoratto <dev@sgregoratto.me>
     <?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>.

Linux 6.12.113+deb13-amd64    September 21, 2021    Linux 6.12.113+deb13-amd64