mprisgovee

light anything up with govee, right from mpris.

showcase

features

• detect song art from any mpris player automatically
• change govee device color with dominant color from song art
  • uses the lan api for extremely fast updates
• multidevice support
• cache colors to avoid reprocessing
• detect play/pause for brightness changes
• app ignoring
• configurable settings

prerequisites

• a computer running linux
• a network connection
• a govee lan api capable device
  • remember to turn on the capability!
    • you can find this in the app by going to your device's settings page.
• python 3.9 or higher
• playerctl installed
• your govee device's ip address:
  1. get the mac address of your device.
     • you can find this in the app by going to your device's settings page.
  2. use any method to match up the mac address with a device ip on your network.
     • i did this by going to my router settings and matching it up under "Device List".

installation

pip

mprisgovee is avaliable on PyPI:

pip install mprisgovee

Arch (AUR)

mprisgovee is avaliable on the AUR for Arch users under python-mprisgovee:

# for yay users
yay -S python-mprisgovee

# for paru users
paru -S python-mprisgovee

usage

you can start it by either manually running mprisgovee from your terminal or running at startup using your favorite method.

example (niri):

spawn-at-startup "mprisgovee"

configuration

the config file can usually be found at ~/.config/mprisgovee/config.toml.

default configuration

govee_ip = ["192.168.1.100", "192.168.1.101"]

govee_port = 4003

brightness_on_play_pause = true

brightness_playing = 100

brightness_paused = 10

ignored_apps = [
    "firefox",
    "chromium",
    "chrome",
    "brave",
    "vivaldi",
    "zen",
    "opera"

• govee_ip:
  • sets the current ip address.
  • format this as a list
• govee_port:
  • sets the current port.
    • this can usually be left default.
• brightness_on_play_pause:
  • enables brightness changes on play/pause.
• brightness_playing:
  • changes the brightness level on play
• brightness_paused:
  • changes the brightness level on pause
• ignored_apps:
  • ignores all apps on list.

thanks to:

• Dynamic Lights Home Assistant - original inspiration
• Govee Dynamic Lights - my spicetify extension which took inspiration from the above