explaingit

qd-today/qd

5,513PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

QD is a self-hosted Python tool that records HTTP requests from your browser and schedules them to run automatically on a timer, making it easy to automate daily website check-ins and other recurring web tasks.

Mindmap

mindmap
  root((QD))
    What it does
      Schedules HTTP tasks
      Automates check-ins
      Runs on a timer
    Inputs
      HAR recordings
      Task templates
    Use Cases
      Daily sign-ins
      Scheduled requests
      Web automation
    Tech Stack
      Python
      Tornado
      Docker
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Automate daily check-ins on websites that reward you with points or coupons for visiting each day.

USE CASE 2

Schedule recurring HTTP requests to any website using a HAR browser recording as a task template.

USE CASE 3

Self-host a task automation server that runs web requests on a timer without any manual effort.

USE CASE 4

Replay a captured browser session automatically every morning to stay logged in or collect daily rewards.

Tech stack

PythonTornadoDocker

Getting it running

Difficulty · moderate Time to first run · 30min

Can be deployed with Docker for easier setup, documentation site is in Chinese and required for advanced template configuration.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

QD is a self-hosted Python tool that lets you record HTTP requests and schedule them to run automatically on a timer. The core idea is built around the HAR format (HTTP Archive), which is a standard way browsers save a snapshot of network traffic from a web session. You capture the requests you want to automate, import them into QD's editor, and set them to run on a schedule. The most common use case, reflected in the topics "checkin" and "qiandao" (the Chinese term for signing in), is automating daily sign-in tasks on websites that reward users for visiting each day. Many Chinese platforms and forums give points, coupons, or other benefits to users who check in daily, and QD handles that automatically without you needing to remember. QD runs as a web application built on a Python server framework called Tornado. It has a browser-based interface for managing tasks, viewing logs, and editing the HTTP request templates. The project can be deployed using Docker, which simplifies setup, or installed directly as a Python application. The tool is written for Python 3, actively maintained with regular monthly commits, and available through Docker Hub as a published image. It is open-source under the MIT license and has 24 contributors listed in the repository. The README is written in Chinese and points to a separate documentation site for detailed usage instructions. The project is primarily aimed at users familiar with Chinese web platforms, though the underlying task automation concept applies to any site that requires scheduled HTTP requests.

Copy-paste prompts

Prompt 1
Help me create a QD task template from a HAR file to automate daily sign-in on a forum that gives points for checking in.
Prompt 2
How do I deploy the QD tool using Docker and set it up to run a scheduled HTTP task every morning at 8am?
Prompt 3
Show me how to add retry logic in a QD template so it tries again if the check-in request fails.
Prompt 4
Help me export a HAR file from Chrome to use as a QD template for automating a login and form submission.
Open on GitHub → Explain another repo

← qd-today on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.