Files
cheatsheet-tldr/tldr/polybar-msg
2025-12-21 00:23:35 +00:00

39 lines
945 B
Plaintext

---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# 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.readthedocs.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}}`