tldr/pages/common/polybar-msg.md

845 B

polybar-msg

Control polybar using inter-process-messaging (IPC). Note: IPC is disabled by default and can be enabled by setting enable-ipc = true in the Polybar config. More information: https://polybar.rtfd.io/en/stable/user/ipc.html.

  • Quit the bar:

polybar-msg cmd quit

  • Restart the bar in-place:

polybar-msg cmd restart

  • Hide the bar (does nothing if the bar is already hidden):

polybar-msg cmd hide

  • Show the bar again (does nothing if the bar is not hidden):

polybar-msg cmd show

  • Toggle between hidden/visible:

polybar-msg cmd toggle

  • Execute a module action (the data string is optional):

polybar-msg action "#{{module_name}}.{{action_name}}.{{data_string}}"

  • Only send messages to a specific Polybar instance (all instances by default):

polybar-msg -p {{pid}} {{cmd|action}} {{payload}}