aisouler/gkd_subscription

★ 11,583TypeScriptAudience · generalComplexity · 1/5Setup · easy

Mindmap

mindmap
  root((gkd-subscription))
    What it does
      Ad dismissal rules
      886 apps covered
      Nightly auto updates
    How it works
      Subscription URL
      GKD reads rules
      Tap automation
    Use cases
      Block splash ads
      Skip pop-ups
      Custom rule sets
    Audience
      Android users
      China region users
      Privacy minded

mindmap root((gkd-subscription)) What it does Ad dismissal rules 886 apps covered Nightly auto updates How it works Subscription URL GKD reads rules Tap automation Use cases Block splash ads Skip pop-ups Custom rule sets Audience Android users China region users Privacy minded

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Subscribe to the rule list in GKD to automatically skip ads and pop-ups in 886 Android apps without needing root access.

USE CASE 2

Use the mainland China mirror URL to get faster rule downloads if GitHub is slow in your region.

USE CASE 3

Study the rule format as a reference for writing your own GKD subscription rules for apps not yet covered.

Tech stack

TypeScriptGKD

Getting it running

Difficulty · easy Time to first run · 5min

In plain English

This repository is a third-party collection of subscription rules for GKD, an Android automation app that automatically dismisses ads, splash screens, and pop-up interruptions inside mobile apps. GKD works by reading a list of rules that tell it which buttons to tap and which elements to skip on each app. This repository provided one such rule list, covering 886 different Android apps with over 2,000 rule groups. The subscription model is straightforward: you copy a URL from this repository into the GKD app, and GKD downloads the rule file from that URL. Rules were published automatically each night at 3 a.m. Beijing time whenever changes were made. Two URL options were available, one hosted on GitHub and one on a Chinese mirror (npmmirror) for users in mainland China where GitHub access can be slow. The rules in this collection aimed for high accuracy and low false positives. Only the category for opening-screen ads was enabled by default, all other rule categories required users to turn them on manually. The README notes that enabling too many rules at once can slow down rule matching and increase battery usage, so the author recommended enabling only what you actually need. As of February 2026, this repository is no longer maintained. The author maintained it for two years before stepping away. The README points newcomers to the official GKD subscription template on GitHub as the preferred way to build and maintain a personal rule set going forward. A Telegram group is listed for community discussion. The README is written in Chinese, and the project was explicitly restricted from being distributed on domestic Chinese platforms per the author's stated terms.

Copy-paste prompts

Prompt 1

How do I add a GKD subscription URL to the GKD Android app so it starts automatically dismissing ads?

Prompt 2

I want to write a GKD rule to skip the splash screen ad in a specific Android app. What does the JSON structure of a GKD rule look like?

Prompt 3

Why does the GKD subscription recommend enabling only the categories you need rather than all rules at once, what happens if I enable everything?

Open on GitHub → Explain another repo

← aisouler on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.