$XDG_CONFIG_HOME/urlwatch/urls.yaml
Configured job and filter list, see urlwatch-jobs(5) and urlwatch-filters(5)
urlwatch1
Monitor webpages and command output for changes
Usage
urlwatch [options]
[JOB ...]
Overview
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.
- positional arguments:
-
- 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.
- optional arguments:
-
-
-h, --help -
show this help message and exit
-
--tags -
use tags instead of indexes to select jobs to run
-
--version -
show program's version number and exit
-
-v, --verbose -
show debug output
-
- files and directories:
-
--urlsFILE-
read job list (URLs) from FILE
--configFILE-
read configuration from FILE
--hooksFILE-
use FILE as hooks.py module
--cacheFILE-
use FILE as cache database
Authentication:-
-
--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-reporterREPORTER-
Send a test notification
-
- job list management:
-
-
--list -
list jobs
--addJOB-
add job (key1=value1,key2=value2,...)
--deleteJOB-
delete job by location or index
--enableJOB-
enable job by location or index
--disableJOB-
delete job by location or index
- --change_location JOB NEW_LOCATION
-
change the location of an existing job by location or index
--test-filterJOB-
test filter output of job by location or index
--test-diff-filterJOB-
test diff filter output of job by location or index (needs at least 2 snapshots)
--dump-historyJOB-
dump historical cached data for a job
-
- interactive commands ($EDITOR/$VISUAL):
-
-
--edit -
edit URL/job list
-
--edit-config -
edit configuration file
-
--edit-hooks -
edit hooks script
-
miscellaneous:-
-
--features -
list supported jobs/filters/reporters
--gc-cacheRETAIN_LIMIT-
remove old cache entries, keeping the latest RETAIN_LIMIT (default: 1)
-
Files
-
$XDG_CONFIG_HOME/urlwatch/urlwatch.yaml -
Global and reporter settings, see
urlwatch-config(5)andurlwatch-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)
Bug tracker
https://github.com/thp/urlwatch/issues
Website
https://thp.io/2008/urlwatch/
Releases
9 releases since Debian 6.0 (Squeeze); the text changed 5 times.
--edit since Debian 10 (Buster);
--edit-config since Debian 10 (Buster);
--edit-hooks since Debian 10 (Buster);
--features since Debian 10 (Buster);
--list since Debian 10 (Buster);
--smtp-login since Debian 11 (Bullseye);
--tags since Debian 13 (Trixie);
--telegram-chats since Debian 11 (Bullseye);
--xmpp-login since Debian 12 (Bookworm).
--add until Debian 11 (Bullseye);
--cache until Debian 11 (Bullseye);
--config until Debian 11 (Bullseye);
--delete until Debian 11 (Bullseye);
--display-errors until Debian 9 (Stretch);
--gc-cache until Debian 12 (Bookworm);
--hooks until Debian 11 (Bullseye);
--test-filter until Debian 11 (Bullseye);
--test-slack until Debian 11 (Bullseye);
--urls until Debian 11 (Bullseye);
-e until Debian 9 (Stretch).