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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file wristwatch-1.3.0.tar.gz.

File metadata

  • Download URL: wristwatch-1.3.0.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.12

File hashes

Hashes for wristwatch-1.3.0.tar.gz
Algorithm Hash digest
SHA256 1dfa0c36ce16ac633b4fc7d218bc8a9312f380ad3a7f8c922cdef33ca9d1cfd1
MD5 1f03c9b83e2c2431db41d455aaff79e9
BLAKE2b-256 c85768ab3df9a545c5ac4c91f2c1956208ae91db95b9a3067e64abfbb46dfa60

See more details on using hashes here.

File details

Details for the file wristwatch-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: wristwatch-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 7.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.12

File hashes

Hashes for wristwatch-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 95923781f8159dc7b209a90ca5cf3a6991b4ebd70d3b81626ffcc8539bfd6092
MD5 df488b46a92a37aaf5e7cc8cf0b1716e
BLAKE2b-256 8f38a7affef843c4227ad05a5df996f99bf84b156870bcfb79c2aaff0331210f

See more details on using hashes here.

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