Check for updates on web pages

Author:James Rowe <>
Copyright:GPL v3
Manual section:1
Manual group:Networking

SYNOPSIS [option]... <command>


cupage checks web pages and displays changes from the last run that match a given criteria. Its original purpose was to check web pages for new software releases, but it is easily configurable and can be used for other purposes.


--version show program’s version number and exit
--help show this help message and exit
-v, --verbose produce verbose output
-q, --quiet output only matches and errors



Add definition to config file

-f <file>, --config <file>
 configuration file to read
-s <site>, --site <site>
 site helper to use
-u <url>, --url <url>
 site url to check
-t <type>, --match-type <type>
 pre-defined regular expression to use
-m <regex>, --match <regex>
 regular expression to use with –match-type=re
-q <frequency>, --frequency <frequency>
 update check frequency
-x <selector>, --select <selector>
 content selector
--selector <type>
 selector method to use


Check sites for updates

-f <file>, --config <file>
 configuration file to read
-d <file>, --database <file>

database to store page data to. Default based on cupage check -f value, for example --config my_conf will result in a default setting of --database my_conf.db.

See Database for details of the database format.

-c <dir>, --cache <dir>

directory to store page cache

This can, and in fact should be, shared between all cupage uses.

--no-write don’t update cache or database
--force ignore frequency checks
-t <n>, --timeout=<n>
 timeout for network operations


List definitions from config file

-f <file>, --config <file>
 configuration file to read
-m <regex>, --match <regex>
 match sites using regular expression


List supported site values


Remove site from config

-f <file>, --config <file>
 configuration file to read


The configuration file, by default ~/.cupage.conf, is a simple INI format file, with sections defining sites to check. For example:

url =
select = p a
site = vim-script
script = 1567

With the above configuration file the site named spill will be checked at, and elements matching the CSS selector p a will be scanned for tarballs. The site named rails will be checked using the vim-script site matcher, which requires only a script value to check for updates in the scripts section of

Various site matchers are available, see the output of --list-sites.


None known.


Written by James Rowe


Home page:


Copyright © 2009-2014 James Rowe.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.