table of contents
URLWATCH(1) | urlwatch Documentation | URLWATCH(1) |
NAME¶
urlwatch - Monitor webpages and command output for changes
SYNOPSIS¶
urlwatch [options] [JOB ...]
DESCRIPTION¶
urlwatch is intended to help you watch changes in webpages and get notified (via e-mail, in your terminal or through various third party services) of any changes. The change notification will include the URL that has changed and a unified diff of what has changed.
See urlwatch-intro(7) for a quick start guide and tutorial, and urlwatch-cookbook(7) for usage recipes and tricks.
This manpage describes the CLI tool.
- JOB
- indexes or tags of job(s) to run. If --tags is set, each JOB is a tag, if not, each JOB is an index numbered according to the --list command.
- -h, --help
- show this help message and exit
- use tags instead of indexes to select jobs to run
- --version
- show program's version number and exit
- -v, --verbose
- show debug output
- --urls FILE
- read job list (URLs) from FILE
- --config FILE
- read configuration from FILE
- --hooks FILE
- use FILE as hooks.py module
- --cache FILE
- use FILE as cache database
- --smtp-login
- Enter password for SMTP (store in keyring)
- --xmpp-login
- Enter password for XMPP (store in keyring)
- --telegram-chats
- List telegram chats the bot is joined to
- --test-reporter REPORTER
- Send a test notification
- --list
- list jobs
- --add JOB
- add job (key1=value1,key2=value2,...)
- --delete JOB
- delete job by location or index
- --enable JOB
- enable job by location or index
- --disable JOB
- delete job by location or index
- --change_location JOB NEW_LOCATION
- change the location of an existing job by location or index
- --test-filter JOB
- test filter output of job by location or index
- --test-diff-filter JOB
- test diff filter output of job by location or index (needs at least 2 snapshots)
- --dump-history JOB
- dump historical cached data for a job
- --edit
- edit URL/job list
- --edit-config
- edit configuration file
- --edit-hooks
- edit hooks script
- --features
- list supported jobs/filters/reporters
- --gc-cache RETAIN_LIMIT
- remove old cache entries, keeping the latest RETAIN_LIMIT (default: 1)
FILES¶
- $XDG_CONFIG_HOME/urlwatch/urls.yaml
- Configured job and filter list, see urlwatch-jobs(5) and urlwatch-filters(5)
- $XDG_CONFIG_HOME/urlwatch/urlwatch.yaml
- Global and reporter settings, see urlwatch-config(5) and urlwatch-reporters(5)
- $XDG_CONFIG_HOME/urlwatch/hooks.py
- A Python 3 module that can implement new job types, filters and reporters
- $XDG_CACHE_HOME/urlwatch/cache.db
- A SQLite 3 database (minidb) that contains the state history of jobs (for diffing)
SEE ALSO¶
urlwatch-intro(7), urlwatch-cookbook(7), urlwatch-deprecated(7), urlwatch-jobs(5), urlwatch-filters(5), urlwatch-config(5), urlwatch-reporters(5)
AUTHOR¶
Thomas Perl <https://thp.io/>
BUG TRACKER¶
WEBSITE¶
COPYRIGHT¶
2024 Thomas Perl
October 28, 2024 | urlwatch |