urlwatch - Man Page

monitors webpages for you


urlwatch [options]


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.

optional arguments

-h, ā€‰--help

show this help message and exit


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



Enter password for SMTP (store in keyring)


List telegram chats the bot is joined to


Send a test notification to Slack

job list management


list jobs

--add JOB

add job (key1=value1,key2=value2,...)

--delete JOB

delete job by location or index

--test-filter JOB

test filter output of job by location or index

interactive commands ($EDITOR/$VISUAL)


edit URL/job list


edit configuration file


edit hooks script



list supported jobs/filters/reporters


remove old cache entries



A list of URLs, commands and other jobs to watch


A Python module that can implement new job types, filters and reporters


A SQLite 3 database that contains the state history of jobs (for diffing)


Thomas Perl <thp.io/about>




January 2019 urlwatch 2.16