wristwatch
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
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--loopargument not working
- 1.0.1
- 1.1.0:
- Added--alertargument to play a sound when changes are detected. - 1.2.0:
- Added--debugargument to show debug info & error messages.
- Changed "rookiepy" dependency for "browser-cookie3"
- Better error handling. - 1.3.0:
- Added--attributeargument to scrape attributes and text content.
- Changed--alertargument 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.