README

   1 URLWATCH README
   2 ===============
   3
   4 ABOUT
   5 -----
   6
   7 This is a simple URL watcher, designed to send you diffs of webpages as they
   8 change. Ideal for watching web pages of university courses, so you always
   9 know when lecture dates have changed or new tasks are online :)
  10
  11
  12 QUICK START
  13 -----------
  14
  15 1. Start "urlwatch"
  16 2. Edit and rename the examples in ~/.urlwatch/
  17 3. Add "urlwatch" to your crontab (crontab -e)
  18 4. Receive change notifications via e-mail
  19 5. Customize your hooks in ~/.urlwatch/lib/
  20
  21
  22 FREQUENTLY ASKED QUESTIONS
  23 --------------------------
  24
  25 Q: How do I add/remove URLs?
  26 A: Edit ~/.urlwatch/urls.txt
  27
  28 Q: A page changes some content on every reload. How do I prevent urlwatch
  29    from always displaying these changes?
  30 A: Edit ~/.urlwatch/lib/hooks.py and implement your filters there. Examples
  31    are included in the urlwatch source distribution.
  32
  33 Q: How do I configure urlwatch as a cron job?
  34 A: Use "crontab -e" to add the command "urlwatch" to your crontab. Make sure
  35    stdout of your cronjobs is mailed to you, so you also get the notifications.
  36
  37 Q: Is there an easy way to show changes of .ics files?
  38 A: Indeed there is. See the example hooks.py file.
  39
  40 Q: What about badly-formed HTML (long lines, etc..)?
  41 A: Use python-utidylib. See the example hooks.py file.
  42
  43 Q: Is there a way to make the output more human-readable?
  44 Q: Is there a way to turn it into a diff of parsed HTML perhaps?
  45 A: Of course. See the example hooks.py file -> use html2txt.html2text(data)
  46
  47
  48 CONTACT
  49 -------
  50
  51 If you like urlwatch, please send me feedback!
  52
  53 Website: http://thpinfo.com/2008/urlwatch/
  54 E-Mail: thp@thpinfo.com
  55 Jabber/XMPP: thp@jabber.org
  56