opensourceprojects.dev

A broadsheet for software that doesn't ask for your email

a customizable screen-click Android app using CSS-like selectors and subscriptio...
GitHub RepoImpressions4

Project Description

View on GitHub

GKD: Automate Android Screen Clicks with CSS-like Selectors

You know that annoying "update now" popup that keeps interrupting your workflow? Or that app that hides its settings behind five taps? GKD is a free, open source Android app that lets you write declarative rules — using CSS-like selectors — to automatically detect and click on specific UI elements.

Think of it as a programmable finger for your phone. You describe what to look for (like TextView[text="Skip"]), and GKD watches the screen and taps it for you. No root required, no Accessibility Service abuse.

What It Does

GKD is a subscription-based screen clicker. You install the app, enable its accessibility service, and then subscribe to rule sets (called "subscriptions") that target specific apps or system dialogs.

The rules are written in a declarative YAML-like format (JSON actually) where selectors work like CSS. For example:

{
  "action": "click",
  "matches": [
    "TextView[text='^更新$'] | TextView[text^='升级']"
  ]
}

This tells GKD: "If you see a TextView with exact text '更新' (Update) or starting with '升级' (Upgrade), click it."

You can chain conditions, wait for elements to appear, apply delays, and even simulate long presses or gestures. Rules can be time based, app specific, or global.

Why It’s Cool

GKD stands out because of three things:

Declarative selectors that feel like CSS. If you've written web scraping rules with CSS selectors, this will feel instantly familiar. No findViewById or UiObject spaghetti. Just Button[text^="关闭"] to close that pesky ad.

Subscription model for community rules. Instead of every user writing their own rules from scratch, GKD uses a subscription system. You can subscribe to rule sets maintained by the community — for removing in-app ads, auto-dismissing update dialogs, or skipping splash screens. The official subscription repo has hundreds of rules for popular Chinese apps (the project originated there), but it works globally.

No heavyweight automation. Unlike Auto.js or Tasker, GKD focuses on one thing: detecting and clicking UI elements. It's lightweight (under 10MB), uses minimal battery, and the accessibility service is only active when needed.

How to Try It

  1. Install the app from GitHub releases: github.com/gkd-kit/gkd/releases
  2. Enable Accessibility Service in Android settings when prompted
  3. Subscribe to a rule set — the app comes with a default subscription, or you can add custom ones from the community.
  4. Watch it work — open an app with an annoying dialog and see GKD dismiss it automatically.

For developers who want to write custom rules, the documentation explains the selector syntax and available actions. There's also a built-in "selector tester" that lets you inspect UI elements on your device in real time.

Final Thoughts

GKD is one of those tools that feels magical the first time it works. You set it up, forget about it, and suddenly your phone stops asking you to update apps every five minutes. For developers, the CSS-like selector approach makes it trivial to write new rules — it's basically scraping for UI.

Is it for everyone? Probably not. But if you're tired of tapping "Skip" on the same ad every day, or you want to automate a repetitive task without learning a full scripting language, GKD is worth the 5 minutes to install.

It's open source, community driven, and respects your privacy (no network access needed). Give it a try — your thumb will thank you.


Follow @githubprojects for more open source discoveries.

Back to Projects
Project ID: 4f535efa-59fc-4b36-9ee8-c5ac481d7c2bLast updated: July 12, 2026 at 05:45 AM