DOKK / manpages / debian 12 / urlwatch / urlwatch.1.en
URLWATCH(1) urlwatch 2.25 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
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


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

2022 Thomas Perl

March 15, 2022 urlwatch 2.25