urlwatch man page

urlwatch — a tool for monitoring webpages for updates

Usage

urlwatch [-h] [--version] [-v]

[--urls FILE] [--config FILE] [--hooks FILE] [--cache FILE]

[--list] [--add JOB] [--delete JOB]

[--edit] [--edit-config] [--edit-hooks]

[--features] [--gc-cache]

Description

urlwatch is intended to help you watch changes in webpages and get notified (via email, in your terminal or with a custom-written reporter class) of any changes. The change notification will include the URL that has changed and a unified diff of what has changed.

optional arguments

-h, --help
show this help message and exit
--version
show program's version number and exit
-v, --verbose
show debug output

files and directories

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

job list management

--list
list jobs
--add JOB
add job (key1=value1,key2=value2,...)
--delete JOB
delete job by location or index

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-cache
remove old cache entries

Files

~/.urlwatch/urls.yaml
A list of URLs, commands and other jobs to watch
~/.urlwatch/hooks.py
A Python module that can implement new job types, filters and reporters
~/.urlwatch/cache.db
A SQLite 3 database that contains the state history of jobs (for diffing)

Author

Thomas Perl <thp.io/about>

Website

http://thp.io/2008/urlwatch/

Info

January 2016 urlwatch 2.0 User Commands