diff --git a/Troubleshooting.md b/Troubleshooting.md
new file mode 100644
index 0000000..4a498f3
--- /dev/null
+++ b/Troubleshooting.md
@@ -0,0 +1,30 @@
+# 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"
+      }
+```
\ No newline at end of file