Troubleshooting

General

In case of trouble running a pypr command:

• kill the existing pypr if any
• run from the terminal adding --debug /dev/null to the arguments to get more information

If the client says it can't connect, then there is a high chance pypr daemon didn't start, check if it's running using ps axuw |grep pypr. You can try to run it from a terminal with the same technique: pypr --debug /dev/null and see if any error occurs.

In case you figure it's broken only when running from hyprland.conf using exec-once:

Run it using the following command and check the log file:

pypr --debug /dev/null > /tmp/pypr_launch_log.txt 2>&1

Scratchpads

Disable PID tracking (eg: emacsclient)

Some apps may open the graphical client window in a "complicated" way, to work around this, it is possible to disable the process PID matching algorithm and simply rely on window's class. The class attribute can be used to achieve this, eg. for emacsclient:

"emacs": {
        "command": "/usr/local/bin/emacsStart.sh",
        "unfocus": "hide",
        "class": "Emacs"
      }

Pypr freezes for some time when it fails showing a scratchpad

This may happen due to some application's behavior, for instance pavucontrol which can freeze on startup without being able to create a window if another instance is running. In that case pypr will wait for a window which will never be available before giving up after a few seconds. For pavucontrol the solution is simple: just kill it (pkill pavucontrol) and try to show the scratchpad that will launch it again!