25 lines
1.1 KiB
Markdown
25 lines
1.1 KiB
Markdown
# Hooks
|
|
|
|
Hooks are optional scripts you write to run your own commands when something in
|
|
Blob happens. None ship active: `hooks/` holds only `.sample` templates, the
|
|
installer copies them to `~/.config/blob/hooks/`, and `blob-hook` skips any file
|
|
ending in `.sample`. Blob's own behaviour, such as recolouring apps on a theme
|
|
change, is built into its scripts and never depends on a hook.
|
|
|
|
To use one, copy the sample without the suffix and edit it:
|
|
|
|
```
|
|
cp ~/.config/blob/hooks/theme-set.sample ~/.config/blob/hooks/theme-set
|
|
```
|
|
|
|
`blob-hook <name>` runs `~/.config/blob/hooks/<name>` and then every file in
|
|
`~/.config/blob/hooks/<name>.d/`, so several scripts can share one event. A
|
|
failing hook prints a message and never stops the command that called it.
|
|
|
|
| Hook | Run by | Argument |
|
|
| --- | --- | --- |
|
|
| `theme-set` | `blob-theme-set`, after a theme is applied | theme name |
|
|
| `font-set` | `blob-font-set`, after the font changes | font name |
|
|
| `battery-low` | `blob-battery-low` | battery percentage |
|
|
| `post-update` | `blob-update`, after a successful update | none |
|