Yet another Python watcher for website updates.
Project description
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.
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1dfa0c36ce16ac633b4fc7d218bc8a9312f380ad3a7f8c922cdef33ca9d1cfd1
|
|
| MD5 |
1f03c9b83e2c2431db41d455aaff79e9
|
|
| BLAKE2b-256 |
c85768ab3df9a545c5ac4c91f2c1956208ae91db95b9a3067e64abfbb46dfa60
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
95923781f8159dc7b209a90ca5cf3a6991b4ebd70d3b81626ffcc8539bfd6092
|
|
| MD5 |
df488b46a92a37aaf5e7cc8cf0b1716e
|
|
| BLAKE2b-256 |
8f38a7affef843c4227ad05a5df996f99bf84b156870bcfb79c2aaff0331210f
|