lizzy

Lizzy is a simple and small app that lets Waybar display what song or media is playing by listening to DBus signals instead of polling.

Features

• Customizable output format (see Usage below)
• Use glob patterns to catch mediaplayers with varying names, such as Firefox
• Support for any MPRIS mediaplayer of preference
• Automatic pause/resume when other media content begins/stops playing (ex. YouTube videos)
• Clearing of output when mediaplayer is closed
• No constant polling, lizzy only updates when a signal is received

Some examples of its output here:

Installation from source

1. Make sure you've got Rust installed. Either via your distributions package manager or rustup.
2. cargo install --git https://github.com/stefur/lizzy lizzy

Configure Waybar

Add a custom module to your Waybar config, something like:

"custom/lizzy": {
    "format": "{icon} {text}",
    "exec": "lizzy",
    "return-type": "json",
    "format-icons": {
      "Playing": "󰐊",
      "Paused": "󰏤"
    },
    "max-length": 45,
    "tooltip": false,
    "escape": true
}

Add whatever flags you want to the command in exec, for example: "exec": "lizzy --format '{{title}}: {{artist}}' --autotoggle"

Don't forget to add the module to your bar!

Usage

Currently the following options can be used to customize the output of lizzy.

Flag	Default value	Description
--format	"{{artist}} - {{title}}"	Format of output, using handlebar tags.
--mediaplayer	None	Mediaplayer interface that lizzy should listen to. Usually the name of the mediaplayer. Simple glob patterns with * are possible. For example firefox* to capture output of any mediaplayer with firefox as the prefix. Blank means listening to all mediaplayers.
--autotoggle	False	Include this flag to automatically pause/resume the mediaplayer if other media content playing is detected (for example a YouTube video)

Example

lizzy --format '{{title}} by {{artist}}' --mediaplayer 'spotify' --autotoggle