Skip to main content

Yet another Python watcher for website updates.

Project description

wristwatch

PyPI version PyPI downloads GitHub license

Yet another Python watcher for website updates.

 

Features

  • Selecting elements to watch with CSS selectors.
  • Automatic importing of cookies from many browsers.
  • Emailing the changes to yourself.
  • Other features...

You can safely quit watching at any time by pressing Ctrl+C.

 

Installation

After having installed Python 3 with pip, you can install wristwatch using the following command:

pip install wristwatch

 

Arguments

Command Example Description
"https://example.com/" The URL of the webpage to scrape.
-b --browser -b "chrome" Name of the browser to get cookies from (by default, any
browser possible). See --help for supported browsers.
-f --frequency -f 60 Frequency of fetches in seconds (default: 60).
-s --selector -s "#minutes" -s "#hours" CSS selector of element(s) to scrape. Can be used multiple times.
-a --attribute -a "href" -a "title" Attribute of the element(s) to scrape. Can be used multiple times.
Can also be "text" to scrape the text content.
-e --email -e "example@gmail.com" Email address to self-send the changes to.
-p --password -p "aaaa bbbb cccc dddd" Email "app" password. Here's a guide on how to generate one.
-i --input -i "input.txt" Load the first fetch from a file.
-o --output -o "output.txt" Save the last fetch to a file.
-q --quiet -q Decrease output verbosity.
-l --loop -l Keep watching for changes even after the first one.
-c --chime -c Play a sound when changes are detected.
-v --version -v Show the program's version.
-h --help -h Show the help message on how to use the program.

 

Examples

wristwatch "https://relaxingclock.com" -s "#minutes" -f 5 -a -l

 

Screenshots

Enter commands

 

Changelog

This changelog only includes changes that are worth mentioning.

  • 1.0.0:
    - Initial release.
    • 1.0.1
      -Specified dependencies version requirements
    • 1.0.2
      -Fixed --loop argument not working
  • 1.1.0:
    - Added --alert argument to play a sound when changes are detected.
  • 1.2.0:
    - Added --debug argument to show debug info & error messages.
    - Changed "rookiepy" dependency for "browser-cookie3"
    - Better error handling.
  • 1.3.0:
    - Added --attribute argument to scrape attributes and text content.
    - Changed --alert argument name to --chime
    - Better error handling.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wristwatch-1.3.0.tar.gz (6.9 kB view hashes)

Uploaded Source

Built Distribution

wristwatch-1.3.0-py3-none-any.whl (7.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page