scratchpads_nonstandard

Troubleshooting configuration options for scratchpads

match_by (optional)

Default value is "pid" When set to a sensitive client property value (eg: class, initialClass, title, initialTitle), will match the client window using the provided property instead of the PID of the process. This property must be set accordingly, eg:

match_by = "class"
class = "my-web-app"

or

match_by = "initialClass"
initialClass = "my-web-app"

You can add the "re:" prefix to use a regular expression, eg:

match_by = "title"
title = "re:.*some string.*"

Note

Added in 2.2.5

class_match (DEPRECATED)

Important

Has been replaced by match_by in versions > 2.2.4

Will set match_by="class" if set to true - support will be dropped in the future.

process_tracking (optional)

Default value is true

Allows disabling the process management. Use only if running a progressive web app (Chrome based apps) or similar. Check this wiki page for some details.

This will automatically force lazy = true and set match_by="class" if no match_by rule is provided, to help with the fuzzy client window matching.

It requires defining a class option (or the option matching your match_by value).

# Chat GPT on Brave
[scratchpads.gpt]
animation = "fromTop"
command = "brave --profile-directory=Default --app=https://chat.openai.com"
class = "brave-chat.openai.com__-Default"
size = "75% 60%"
process_tracking = false

# Some chrome app
[scratchpads.music]
command = "google-chrome --profile-directory=Default --app-id=cinhimbnkkaeohfgghhklpknlkffjgod"
class = "chrome-cinhimbnkkaeohfgghhklpknlkffjgod-Default"
size = "50% 50%"
process_tracking = false

Tip

To list windows by class and title you can use:

• hyprctl -j clients | jq '.[]|[.class,.title]'
• or if you prefer a graphical tool: rofi -show window