mprisgovee 1.0.0

light anything up with govee, right from mpris.

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
• cache colors to avoid reprocessing
• 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

usage

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

example (niri):

spawn-sh-at-startup "mprisgovee"

configuration

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

default configuration

{
    "govee_ip": "192.168.1.100",
    "govee_port": 4003
}

• govee_ip:
  • sets the current ip address.
• govee_port:
  • sets the current port.
    • this can usually be left default.

thanks to:

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