mirror of
https://github.com/eth-p/bat-extras.git
synced 2024-12-13 17:50:56 +01:00
54 lines
1.7 KiB
Markdown
54 lines
1.7 KiB
Markdown
# bat-extras: batwatch
|
|
|
|
Watch for changes in files or command output, and print them with `bat`.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
batwatch [OPTIONS] FILE...
|
|
|
|
batwatch [OPTIONS] --command COMMAND [ARG...]
|
|
|
|
|
|
|
|
## Options
|
|
|
|
| Short | Long | Description |
|
|
| ----- | ---------------------- | ------------------------------------------------------------ |
|
|
| | `--command`\|`-x` | Execute a command on an interval. |
|
|
| | `--file`\|`-f` | Watch a file for changes. |
|
|
| | `--watcher=[watcher]` | Use a specific program to watch for file changes. See [below](#watchers) for more details. |
|
|
| | `--interval=[seconds]` | The interval for executing commands. |
|
|
| | `--clear` | Clear the screen before printing the files.<br />This is enabled by default. |
|
|
| | `--no-clear` | Do not clear the screen before printing the files. |
|
|
| | `--color` | Force color output. |
|
|
| | `--no-color` | Force disable color output. |
|
|
|
|
All remaining options are passed through to bat.
|
|
|
|
|
|
|
|
## Watchers
|
|
|
|
Batwatch uses external programs to watch for file changes.
|
|
Currently, the following programs are supported:
|
|
|
|
- [entr](https://eradman.com/entrproject/)
|
|
|
|
There is also a fallback `poll` watcher available.
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
This script is a part of the `bat-extras` suite of scripts. You can find install instructions [here](../README.md#installation).
|
|
|
|
|
|
|
|
|
|
## Issues?
|
|
|
|
If you find an issue or have a feature suggestion, make a pull request or issue through GitHub!
|
|
Contributions are always welcome.
|