Skip to main content

Watchdogs to keep an eye on the world's change. Read more:

Project description

watchdogs PyPIPyPI - WheelPyPI - Python VersionPyPI - DownloadsPyPI - License

Keep an eye on the change of web world.

Such as post articles / news on the web portal / server api health / binge-watching / steam price fluctuation / github events / updates of comic and novel, and so on...



  1. This is a web app based on fastapi, databases, uniparser, torequests.
  2. Smoothly deploy it by pip: pip install -U watchdogs;python3 -m watchdogs
  3. Simple to create a new crawler with the Web UI, not like old ways to write duplicate code.
  4. All the crawlers keep runing in the async environment.
  5. Almost all the elements have a title attribute to describe the features in the Web UI, which means docs lay on the UI.
  6. Release your hands from repetitive refreshing pages on the browser.
    1. Subscribe the change events with RSS reminder extensions, such as Feedbro or RSS Feed Reader.
    2. Implement a class which inherits from watchdogs.callbacks.Callback.


  1. pip install -U watchdogs

  2. python -m watchdogs

  3. Open the browser:

Command line args

python -m watchdogs -- -h

  • db_url:

sqlite / mysql / postgresql(not test) url, which databases supports. Defaults to 'sqlite:///{HOME_PATH}/watchdogs/storage.sqlite'

  • password:

init password, if null can be set on the first visit on web.

  • mute_std_log:

remove stdout log for clean stream

  • mute_file_log:

ignore file log located at {HOME_PATH}/watchdogs folder.

  • md5_salt:

md5_salt for custom md5(password) / md5(rss_tag)

  • config_dir:

config dir to save the logs and config files, if using sqlite include sqlite file. defaults to {HOME_PATH}/watchdogs

  • use_default_cdn:

If Config.cdn_urls not set, and use_default_cdn is True, will use online js/css cdn links from

  • **uvicorn_kwargs:

uvicorn startup kwargs, such as port, host. Which can be set like: python -m watchdogs --port=9999 --host= --access-log=False

Quick Start to Create New Task

Quick Start Screenshots

Web UI

  1. Welcome Page (Tasks Page).

Here you can see all the tasks meta, goto RSS / Mobile Lite Page, and do some operations to the tasks.


  1. New Task Page.

Here based on the latest uniparser web app, to create new rules and also tasks.


  1. Rules Page.

Do some operations for the rules.


  1. API page.

Based on fastapi /docs which is generated automatically.


  1. Mobile Page (Lite View).

For mobile phone to glimpse the latest result for the current 30 tasks.


Project details

Download files

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

Files for watchdogs, version 1.8.2
Filename, size File type Python version Upload date Hashes
Filename, size watchdogs-1.8.2-py3-none-any.whl (305.9 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page