URLWATCH(1)               urlwatch 2.28 Documentation              URLWATCH(1)

NAME
       urlwatch - Monitor webpages and command output for changes

SYNOPSIS
       urlwatch [options] [JOB ...]

DESCRIPTION
       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    index of job(s) to run, as numbered according to the
                     --list command.  If none are specified, then all jobs
                     will be run.

       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

       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-reporter REPORTER
                     Send a test notification

       job list management:

              --list list jobs

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

              --delete JOB
                     delete job by location or index

              --change_location JOB NEW_LOCATION
                     change the location of an existing job by location or
                     index

              --test-filter JOB
                     test filter output of job by location or index

              --test-diff-filter JOB
                     test diff filter output of job by location or index
                     (needs at least 2 snapshots)

              --dump-history JOB
                     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-cache RETAIN_LIMIT
                     remove old cache entries, keeping the latest RETAIN_LIMIT
                     (default: 1)

FILES

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

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

AUTHOR
       Thomas Perl <https://thp.io/>

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

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

COPYRIGHT
       2023 Thomas Perl

urlwatch 2.28                     May 3, 2023                      URLWATCH(1)