URLWATCH(1) urlwatch 2.28 Documentation URLWATCH(1)

urlwatch - Monitor webpages and command output for changes

urlwatch [options] [JOB ...]

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.

index of job(s) to run, as numbered according to the --list command. If none are specified, then all jobs will be run.
show this help message and exit
show program's version number and exit
show debug output
read job list (URLs) from FILE
read configuration from FILE
use FILE as hooks.py module
use FILE as cache database
Enter password for SMTP (store in keyring)
Enter password for XMPP (store in keyring)
List telegram chats the bot is joined to
Send a test notification
list jobs
add job (key1=value1,key2=value2,...)
delete job by location or index
change the location of an existing job by location or index
test filter output of job by location or index
test diff filter output of job by location or index (needs at least 2 snapshots)
dump historical cached data for a job
edit URL/job list
--edit-config
edit configuration file
--edit-hooks
edit hooks script
list supported jobs/filters/reporters
remove old cache entries, keeping the latest RETAIN_LIMIT (default: 1)

$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)

urlwatch-intro(7), urlwatch-cookbook(7), urlwatch-deprecated(7), urlwatch-jobs(5), urlwatch-filters(5), urlwatch-config(5), urlwatch-reporters(5)

Thomas Perl https://thp.io/

https://github.com/thp/urlwatch/issues

https://thp.io/2008/urlwatch/

2023 Thomas Perl

May 3, 2023 urlwatch 2.28