Skip to main content

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.

Metadata

Release files for wristwatch 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wristwatch 1.3.0
File Size Uploaded Provenance Actions
wristwatch-1.3.0.tar.gz 6.9 kB Without provenance Details for wristwatch-1.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for wristwatch 1.3.0
File Interpreter ABI Platform Actions
wristwatch-1.3.0-py3-none-any.whl Python 3 none any Details for wristwatch-1.3.0-py3-none-any.whl

Total release size: 14.3 kB

Release files / wristwatch-1.3.0.tar.gz

Download URL wristwatch-1.3.0.tar.gz
Size 6.9 kB
Tags Source
SHA-256 checksum
How to use checksums
1dfa0c36ce16ac633b4fc7d218bc8a9312f380ad3a7f8c922cdef33ca9d1cfd1
BLAKE2b-256 checksum
How to use checksums
c85768ab3df9a545c5ac4c91f2c1956208ae91db95b9a3067e64abfbb46dfa60
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.10.12

Release files / wristwatch-1.3.0-py3-none-any.whl

Download URL wristwatch-1.3.0-py3-none-any.whl
Size 7.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
95923781f8159dc7b209a90ca5cf3a6991b4ebd70d3b81626ffcc8539bfd6092
BLAKE2b-256 checksum
How to use checksums
8f38a7affef843c4227ad05a5df996f99bf84b156870bcfb79c2aaff0331210f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.10.12

Security for wristwatch 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page