mirror of
https://github.com/eth-p/bat-extras.git
synced 2024-12-15 10:40:41 +01:00
51 lines
1.5 KiB
Markdown
51 lines
1.5 KiB
Markdown
# bat-extras: batwatch
|
|
|
|
Watch for changes in one or more files, and print them with `bat`.
|
|
|
|
Please note this watches filesystem files, and not command output like `watch(1)`.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
batwatch [OPTIONS] FILE...
|
|
|
|
|
|
|
|
## Options
|
|
|
|
| Short | Long | Description |
|
|
| ----- | --------------------- | ------------------------------------------------------------ |
|
|
| | `--watcher=[watcher]` | Use a specific program to watch for file changes. See [below](#watchers) for more details. |
|
|
| | `--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](http://entrproject.org/)
|
|
|
|
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.
|