.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "POLYBAR-MSG" "1" "Nov 28, 2023" "3.7.1" "Polybar User Manual"
.SH NAME
polybar-msg \- Send IPC messages to polybar
.SH SYNOPSIS
.nf
\fBpolybar\-msg\fP [\fIOPTIONS\fP] \fBaction\fP \fIaction\-string\fP
\fBpolybar\-msg\fP [\fIOPTIONS\fP] \fBaction\fP \fImodule\fP \fIaction\fP [\fIdata\fP]
\fBpolybar\-msg\fP [\fIOPTIONS\fP] \fBcmd\fP \fIcommand\fP
.fi
.sp
.SH DESCRIPTION
.sp
Polybar allows external control through \fIactions\fP and \fIcommands\fP\&.
Actions control individual modules and commands control the bar itself.
.sp
The full IPC documentation is linked at the end of this document.
.sp
The available actions depend on the target module.
For actions, the payload is either a single action string or the module name,
the action name, and the optional data string specified separately.
.sp
In order for \fBpolybar\-msg\fP being able to send a message to a running
\fBpolybar\fP process, the bar must have IPC enabled and both \fBpolybar\-msg\fP and
\fBpolybar\fP must run under the same user.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-h, \-\-help
Display help text and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-p PID
Send message only to \fBpolybar\fP process running under the given process ID.
If not specified, the message is sent to all running \fBpolybar\fP processes.
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.TP
\fBpolybar\-msg\fP \fBcmd\fP \fIquit\fP
Terminate all running \fBpolybar\fP instances.
.UNINDENT
.sp
\fBpolybar\-msg\fP \fBaction\fP \fImymodule\fP \fImodule_hide\fP
.INDENT 0.0
.TP
\fBpolybar\-msg\fP \fBaction\fP \(dq\fI#mymodule.module_hide\fP\(dq
Hide the module named \fImymodule\fP\&.
The first variant specifies the module and action names separately, the second uses an action string.
.UNINDENT
.SH AUTHORS
.nf
Polybar was created by Michael Carlberg and is currently maintained by Patrick Ziegler.
Contributors can be listed on GitHub.
.fi
.sp
.SH REPORTING BUGS
.sp
Report issues on GitHub <\fI\%https://github.com/polybar/polybar\fP>
.SH SEE ALSO
.sp
\fBpolybar\fP(1),
\fBpolybar\fP(5)
.nf
IPC documentation: <\fI\%https://polybar.rtfd.org/en/stable/user/ipc.html\fP>
.fi
.sp
.SH COPYRIGHT
2016-2023, Michael Carlberg & contributors
.\" Generated by docutils manpage writer.
.