diff --git a/docs/configuration.rst b/docs/configuration.rst index b5a4d82..3cf3a95 100644 --- a/docs/configuration.rst +++ b/docs/configuration.rst @@ -367,3 +367,30 @@ Or make two modules look like one. hints = {"separator": False, "separator_block_width": 0}, text = "Antidisestabli", color="#FF0000") + +.. _refresh: + +Refreshing the bar +------------------ + +The whole bar can be refreshed by sending SIGUSR1 signal to i3pystatus process. +This feature is available only in standalone operation (:py:class:`.Status` was +created with `standalone=True` parameter). + +To find the PID of the i3pystatus process look for the ``status_command`` you +use in your i3 config file. +If your `bar` section of i3 config looks like this + + .. code:: + + bar { + status_command python ~/.config/i3/pystatus.py + } + +then you can refresh the bar by using the following command: + + .. code:: bash + + pkill -SIGUSR1 -f "python /home/user/.config/i3/pystatus.py" + +Note that the path must be expanded if using '~'.