Remote Control

Media keys

Media keys should be automatically handled by your desktop environment and forwarded to media players using MPRIS2 via D-Bus (Linux only). For GNOME and KDE, no extra configuration should be needed.

macOS media keys are not currently supported.

Commands

Using playerctl (Linux only)

You can use playerctl (Arch Linux package), which uses MPRIS2 for additional controls (volume, shuffle, etc.).

Example:

playerctl -p tauon play

Using D-Bus directly (Linux only)

If playerctl isn’t working for you, you can send commands over D-Bus manually using dbus-send.

Example: switch to the next track

dbus-send --print-reply --session --dest=org.mpris.MediaPlayer2.tauon /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Next

Note

Tauon does not implement the tracklist or playlists MPRIS interface.

Tauon launch options

There are also some Tauon launch commands you can use.

• If installed via AUR, the CLI command is tauon.
• If installed via Flatpak, use:

flatpak run com.github.taiko2k.tauonmb

Options:

--play
--pause
--play-pause
--stop
--next
--previous
--shuffle   (this toggles shuffle)
--repeat    (this toggles repeat)

For example:

tauon --pause

You can also open files, for example:

tauon ~/Music/Myalbum/mysong.mp3

Network / advanced control

Android app (unmaintained)

See the wiki list of known Android remote control apps: https://github.com/Taiko2k/TauonMusicBox/wiki/Android-Remote-Apps

Using Tauon’s HTTP API

For advanced control (developers), you can use the remote HTTP API. See the wiki page: https://github.com/Taiko2k/TauonMusicBox/wiki/Remote-Control-API

This must be enabled in Tauon’s settings.