# Someone else's video got 1.5M views, but the code was never released. An iOS engineer delivered a downloadable "AirPods mouse" in 20 hours · GitHub open-source project

> Source: https://stringers.io/en/github/gh_m-afham__AirCursor.html (Stringers / 什么值得做, generated 2026-11-20)
> Stringers tracks which small products suddenly took off each day, investigates why one by one, and distils playbooks from them. Numbers come from 15 databases we collect daily, each with source and date.
> For agents: these investigations and the underlying databases (verified revenue, App Store / Google Play charts, ad libraries, GitHub, Product Hunt…) are queryable live over MCP — tools feed (daily breakouts) / plays (playbooks) / hot / products / data. Setup: https://github.com/komako-workshop/stringers (the user signs in with Google at stringers.io/en/start.html to get a personal URL). Site index: https://stringers.io/llms.txt

> An X video of "AirPods charging case as a mouse" got 1.5M views but no code. 20 hours later, AirCursor delivered a downloadable version that works right after install, and AI tool accounts on Instagram that run "comment for link," Hong Kong media, and Chinese listicles passed it around as the answer.

[GitHub open-source project](https://stringers.io/en/github/index.md) · written 11-14

m-afham/AirCursor · m-afham

# Someone else's video got 1.5M views, but the code was never released. An iOS engineer delivered a downloadable "AirPods mouse" in 20 hours.

**What it is:** a free, open-source Mac menu bar tool. Wearing AirPods, you turn your head to move the pointer; hover over a button and nod or pinch the earbud stem to click.

**Why it blew up:** an X video of "AirPods charging case as a mouse" got 1.5M views but no code. It shipped a downloadable, ready-to-run version 20 hours later, and was passed around as the answer by Instagram AI-tool accounts that gate links behind comments, Hong Kong media, and Chinese roundup articles.

**C** **How you could copy it** Stop building AirPods mice. Copy the play instead: watch comment sections for demos where people beg "open source please," and within 24 hours of the creator's open-source drop, ship a complete version with an installer, onboarding, and a clean README, built with AI. If you want to stay on this topic, go for the accessibility angle or a Windows version.

Grade C: Racing a viral demo to ship before it's open-sourced is worth copying, but the same topic already has a dozen-plus repos, and the window closed once the original went open source and quickly passed it. Projects like this usually stall at a few hundred stars, and you have to wait for the next video, so you can't plan it. Spreading in small circles

Data (updated daily) · Repo created 2026-11-04 · 259 stars · 7 days +128

GitHub · stars

Data 2026-11-06 → 2026-11-20 (15 days, 15 observations). Points before 10-28 come from deeply / archive backfill, not every day has one

AirCursor is a Mac menu bar tool that moves your cursor when you turn your head while wearing AirPods. It's open source and free. The repo was 11 days old when it hit 200 stars. The idea isn't its own, and neither is the buzz: it shipped the first one-click download that works right after install, just before the creator of a viral video open-sourced his code, so it became the answer to "where's the code." The play is worth copying, but the AirPods mouse topic is already crowded with a dozen-plus repos, and the window has closed.

### A video with no code

Around 2026 Nov 4 (UTC 02:15), Andy Gao posted a video on X: "I turned my AirPods case into a mouse, and it works pretty well." The post later got 1.5M views and 400 replies, and almost every reply asked the same thing: where's the code? He didn't share it at the time.

About 20 hours later (UTC 22:20), Pakistani iOS engineer Muhammad Afham pushed the first commit for AirCursor, and half an hour after that he posted 1.0. What he actually built wasn't about holding the charging case. You wear the earbuds and steer the pointer with head movements. But for the crowd that saw the video and wanted to try it right away, this was "AirPods as a mouse," and it was downloadable.

Andy's own repo 11-06 was released. For the two days in between, AirCursor was almost the only thing you could install.

作者在 GitHub 上只有 22 个关注者,没有 X 账号,这是他唯一的公开仓库。他的个人站写着 7 年 iOS 经验,技能栏里明写了「Claude Code / AI 辅助开发」。第一天就拿出完成度这么高的 1.0,要么之前有底子,要么 AI 帮了大忙(推断,两者都可能)。

### What it is

Once installed, turning your head while wearing AirPods moves the pointer. The README's first line repeats the line from the viral post: "Your AirPods are now a mouse." There are several ways to click:

- Hold the pointer on a button and click when a ring fills. It only works on clickable things like buttons, links, and tabs, so resting on body text to read won't trigger a click by mistake.

- Nod for left click, and the click lands where you were pointing before the nod.

- Pinch the earbud stem once for left click, twice for right click, three times to enter scroll mode.

- Shake your head to pause, and tilt to set forward/back or switch desktops.

The first launch has a one-minute setup: grant two permissions, connect your earbuds, then have you click something for real while it measures how far you nod and auto-tunes sensitivity. A pair of 3D earbuds next to it moves live with your head. If something breaks, a diagnostics panel checks permissions, Bluetooth, audio output, and sensor data one by one, and flags the first step that fails.

It uses Apple's public earbud motion API, and it works with AirPods Pro, Max, 3th-gen, and Beats Fit Pro. No camera, no extra hardware, and unlike the case-based approach, it doesn't cut audio.

### Where users come from

The author barely promoted it. The stars came from others, mainly through four channels:

1. **AI tool accounts on Instagram** . 11-04 and 11-05 had accounts using the case video as a hook, with captions like "comment MOUSE and I'll send you the link," which sent people to AirCursor. 11-13, an Indian account with 29K followers posted another with the same pattern, "comment Code and I'll DM you the repo link." Right after, 11-14 gained 15 forks in a day, mostly from accounts with Indian names; 11-15 stars rose 67 in one day, versus 2 the day before (GitHub, 11-14/15). Attributing this wave is an inference, but the timing and audience fit.

2. **Media got the name wrong** . Hong Kong's HKEPC 11-05 headlined it "Developer turns AirPods into wireless mouse 'AirCursor'," but the article and video are about Andy's charging case. A YouTube video checking the "AirPods mouse" named AirCursor as the real thing you wear in your ears.

3. **Chinese listicle articles** . On Zhihu and Woshipm (11-10), the same article "3 GitHub open-source tricks for using your AirPods as a mouse" opens with "It's popular overseas, the author says he'll open source it but hasn't yet, so I found some similar ones." 11-05 a Chinese developer even submitted a PR to it, and it was merged.

4. **Developers are using it as a base** . An X post demoing a Mac app built with Opus 5.5 openly says the pointer mapping is based on m-afham/AirCursor, and the generated repo README says the same.

It never appeared on Hacker News, never launched on Product Hunt, got no feature story from major English tech outlets, and ran no ads.

Downloads outnumber stars: the installers across releases were downloaded 1,700 times in total (GitHub Releases, 11-14), and 1.0.7 one release alone was downloaded 900 times. Lots of people installed it, and only some of them starred it.

### Who it's competing with

Within a week of the video going viral, a dozen-plus same-topic repos appeared. AirCursor wasn't the first and didn't have the most stars:

| Project | Launched | star(11-14) | Approach |
|---|---|---|---|
| MousePods | 11-04 | 469 | Reverse-engineering the AirPods 3 Bluetooth protocol on Linux, with the story "reverse-engineered with Claude Code"; covered by Hackaday and AppleInsider |
| AirPointer (Andy's own) | 11-06 | 404 | The original, holding the closed case as an air mouse; it reached 262 within two days of release and passed AirCursor at twice the speed |
| AirCursor | 11-04 | 207 | Head control with AirPods, a native Mac app, one-click download |
| A same-named airpointer | 11-06 | 194 | Piggybacked on the original's name, with a description saying "this is the only REAL repo" |
| UnMagic Mouse | 11-06 | 9 | Tilt the case to control the cursor; TikTok video with 1.55M views and 90K likes, but it barely turned into stars |
| PodMouse, APMouse, and others | 10-29 ~ 11-09 | 0–7 | Few features, no installer; one directly based on AirCursor |

Two more useful comparisons: a year earlier someone had already built the same AirPods head-control mouse (AirpodHeadmouse, 2025-10), which has 13 stars today; and Apple's system has long had "head pointer," though it uses the camera. The idea existed for a long time. What it lacked was that video.

### Why it got picked

Out of a dozen-plus repos on the same topic, repost accounts, media, and listicle articles picked this one, for specific reasons:

- **Early** . It could be downloaded two days before the original went open source, and it was the only option for people asking for the code.

- **Easy to share** . A big "Download for Mac" button sits at the top of the README, with screenshots below, followed by "MIT, free, no data collection." For an account sending links in DMs, this is the link least likely to draw complaints.

- **It actually works after install** . Onboarding, auto-calibration, hover-to-click only on clickable things, and a diagnostics panel mean ordinary users don't get stuck after downloading.

- **Looks trustworthy** . It only checks GitHub for updates, verifies signatures on update packages, and the author wrote a long post about the pitfalls of permissions breaking after a Mac app self-updates. This made developers willing to use it as a base.

But that's also its ceiling. The original overtook it as soon as it went open source, and the one with the "reverse-engineering" story, MousePods, got the mainstream tech coverage. AirCursor got a third-place share. Head-controlled mice are a novelty, and most people try one and put it down.

### If it were you

**Verdict** : C. The play of "a viral demo hasn't been open-sourced, so ship a downloadable full version first" is worth copying, and AirCursor shows 20 hours is enough. But the AirPods mouse topic is already crowded with a dozen-plus repos, the original is open source too, and making another one now won't get many stars. And this play depends on catching the next video each time, so you can prepare for it but not plan it.

**Who it suits** : developers who move fast and can use AI to ship a complete app with an installer and onboarding within a day, especially native Mac/iOS builders who already scroll X and TikTok for hardware and interaction demos.

**Who it doesn't suit** : anyone wanting to build another AirPods mouse (the slot is full and the window closed); anyone hoping one project will bring thousands of stars and fame (riding-the-hype projects like this usually stall at a few hundred); anyone who only wants to write code and not handle the README and install experience (AirCursor won on those things, not on the algorithm).

**How to do it** : watch demos on X and TikTok where comments are full of "open source please" and "where's the code," especially where the creator says "will release in a few days." Confirm it can be built on public APIs (skip reverse engineering; it covers more devices and installs cleanly), then within 24 hours ship a one-click download: use the line from the viral post as the title, put a big download button and screenshots on the first screen of the README, state open source, free, and no data collection, and include onboarding on first launch. If you want to stay on this topic, do the part nobody has done well: an accessibility version for people with limited upper-body mobility or wrist strain (that's the long-term need for head-controlled mice), or a Windows version.

**How to get stars** : don't count on TikTok views. UnMagic Mouse had 1.55M views and only 9 stars. Stars come from channels with clickable links: "comment a keyword to get the link" AI tool accounts on Instagram (they find you on their own and post in waves), Chinese tech listicle articles, leaving the repo address in replies to the original post, and getting other developers to build on yours. Your job is to make the README the link they most want to share.

**When it's already too late** : the AirPods mouse topic is past. The play works any time, but each window only lasts the day or two before the original creator open-sources.

**Signs you misread it** : (1) AirCursor keeps growing from these repost waves and passed 500 stars by late November, which would mean the most polished version captures the long tail, so a later entry still has a share; (2) someone turns head-controlled mice into an accessibility tool that spreads in this community, which would mean the long-term demand for this topic is bigger than novelty and worth building seriously; (3) conversely, if AirCursor stalls at a little over 200, then these projects only pay off in one wave and are only good for practice and building a name.

[GitHub repo ↗](https://github.com/m-afham/AirCursor)

**Research notes: competitor table, acquisition evidence, full research report**

Competitors

| Name | Where | Launched | Scale | How it differs from this one |
|---|---|---|---|---|
| musubipapi/airpointer (AirPointer, Andy Gao's original) | Open source | 2026-11-06 | 404 star / 52 fork(11-07 168 → 11-08 262) | Holds the closed case as an air mouse, which cuts audio and drains case diagnostics; AirCursor uses head control with earbuds over public APIs, and was downloadable two days earlier |
| starman-tech/mousepods(MousePods) | Open source | 2026-11-04 | 469 stars; covered by Hackaday, AppleInsider, Hackster | Reverse-engineers the RemoteHID protocol of AirPods 3 on Linux, with the story "Claude Code reverse-engineering"; AirCursor is Mac-only and does not reverse-engineer |
| oscarcreatess/airpointer | Open source | 2026-11-06 | 194 star | Piggybacks on the AirPointer name (claims "only REAL repo"), case-based approach |
| Coolerwave/unmagic-mouse(UnMagic Mouse) | Open source | 2026-11-06 | 9 stars; TikTok 1.55M views / 90K likes | Case tilt control; TikTok traffic barely converted to stars |
| willwade/AirpodHeadmouse | Open source | 2025-10-05 | 13 star | The same head-control mouse was built a year earlier but had no viral moment, no installer, and no onboarding |
| JNDZdev/APMouse, 0xCodez/PodMouse, gintmr/NodLink and other small same-topic repos | Open source | 2026-10-29 ~ 11-09 | 0–7 stars (NodLink got a feature article on sspai) | Few features, no download package or onboarding; PodMouse is directly based on AirCursor |
| ScrollPods | Other | 2025-11-13(Mac App Store) | Free, 0 rating on the US App Store | Head-controlled scrolling only, not a mouse |
| Cogria-AI/HeadOrbit | Open source | 2026-09-13 | 260 star | Same idea of reading AirPods head motion, but it blurs the screen when you turn your head and reminds you about posture. It doesn't control the cursor. |
| macOS Head Pointer | Big-company features | since macOS Catalina (2019) | System level | Tracks your face with the camera; AirCursor doesn't use a camera |
| SmartNav / Glassouse / Enable Viacam | Other | Years | Niche accessibility market | Needs extra hardware or a camera; AirCursor uses headphones you already own, at zero cost |

Where users come from

- **Verified** **Platform event: Andy Gao's charging-case mouse viral video** : X @instantricecook, 2026-11-04 02:15 UTC, 1.5M views, 442 replies, comments asking for open source; the original author only open-sourced it 11-06. AirCursor's first commit: 11-04 22:20 UTC.

- **Verified** **Instagram AI-tool repost accounts (comment-keyword lead magnets)** : @theaiskool 11-05 "Meet AirCursor…"; @creativelyange's "comment MOUSE for the link" caption points to AirCursor's address; @ishandutta.ai (28.8k followers) 11-13 "Comment Code" with the same template. Matched against 11-14 15 Indian-account forks and 11-15 +67 stars.

- **Verified** **Media misattribution** : HKEPC 11-05 article headline "開發者將 AirPods 變成無線滑鼠『AirCursor』" (developer turns AirPods into wireless mouse 'AirCursor'). The body is Andy's charging-case video, syndicated to FB/Threads/IG. YouTube fact-check video OmniTech Daily names AirCursor.

- **Verified** **Chinese listicles** : a Zhihu column, Everyone Is a Product Manager (11-10), and Yunzhan community (11-13) with "Use your AirPods as a mouse: these 3 hardcore GitHub open-source projects" all list AirCursor. Domestic accounts 11-05 and 11-10 submitted PRs/forks.

- **Verified** : developers building on **the same base** : @0xMovez 11-05 Opus 5.5 demo prompt credits m-afham/AirCursor; 0xCodez/PodMouse and kvx07/iphonehandmouse READMEs cite it

- **Verified** **Author-owned content** : 11-09 added author credit and a social preview card; 11-10 long blog post on self-updating and TCC permissions. No X account.

- Inferred **HN / Reddit / TikTok / ads** : the hackernews dataset has no related posts in the last 30 days; Reddit related posts were blocked and unverified; TikTok search only surfaces UnMagic Mouse and AirPointer hits, no dedicated AirCursor video; no ad evidence.

## m-afham/AirCursor: turn your AirPods into a Mac mouse

> Research date 2026-11-14 (data card refreshed to 11-15). Repo [github.com/m-afham/AirCursor](https://github.com/m-afham/AirCursor), MIT, Swift/SwiftUI menu bar app, zip shipped directly via GitHub Releases.

### Bottom line

AirCursor is **a vehicle that caught a viral video** : 2026-11-04 02:15 UTC, Andy Gao (@instantricecook) posted on X, "I turned my AirPods charging case into a mouse", 1.5M views, the replies all asking for the code, but he had not released any. About 20 hours later (11-04 22:20 UTC), Muhammad Afham, a senior iOS engineer from Pakistan, pushed AirCursor 1.0. It does something different (head-controlled mouse using the headphones you're wearing, not squeezing the case), but it was **the first one-click download that installs and works, with a polished finish, for "AirPods as a Mac mouse"** . So Instagram AI-tool repost accounts, Hong Kong media HKEPC, and Chinese "3 hardcore open-source projects" listicles on Zhihu and Everyone Is a Product Manager used it to answer "where's the code". The stars came mostly from this demand spillover; the product craft (onboarding, hover-click that only triggers on clickable controls, auto-calibration of nod range, signed self-update) is why it became the one being cited, rather than the dozen other repos from the same period.

### 1. Data

- GitHub stars (our github repo_day): 11-06 40 → 11-07 61 → 11-09 87 → 11-11 116 → 11-12 131 → 11-13 131 → 11-14 133 → 11-15 200 (single-day +67). 11-14 The API shows 207 stars and 26 forks so far. Repo created 11-04, under 60 days old, not yet on trending.

- Fork timestamps (GitHub API): 11-05 4 forks, 11-06 1, 11-08 1, 11-10 2, 11-11 2, 11-13 1, **11-14 15 forks in a single day** , and most came from accounts with Indian names (RNKbansal23, GAUTAMMISTRY, Sandeep-Hipparagi, Divyanshu0-0, Abhinandandg…). That suggests the spike on 11-15 came from Indian traffic.

- Downloads (GitHub Releases download counts, as of 11-14): total across versions roughly 1,700 (the stable link AirCursor.zip has 1,352, versioned zips 347, the latter partly from in-app self-updates since 1.0.5). 1.0.2 (11-05) 326, 1.0.7 (11-10) 885, so installs outnumber stars.

- Community: 7 PRs (2 from a domestic account 674019130, submitted in 11-05 and merged; 1 Kalman-filter and personal calibration PRs from Yuxin-Ren-SZ), 1 issues. The author set up CI, AI-assisted PR review, auto-merge for trusted authors, and automated releases.

- Author: 22 GitHub followers, no X account; personal site mafham.dev states 7 years of iOS experience, built the editor for a design app that reached top 10 in the US Graphics & Design category, and the Kinde iOS SDK; skills list explicitly says "Claude & Claude Code / AI-assisted development". 11-09 commit "Add author credit, feedback paths and a social preview card" plus 11-10 long post "Self-updating a macOS app without losing its permissions" are the only promotion we could find from the author. It leans toward engineering credibility, not paid acquisition.

### 2. Competitors: who else is doing the same thing

This topic suddenly filled up in the first week of November, and the trigger was all Andy Gao's video. The table below separates by what each one does:

| Project | Where | Launched | Scale (11-14/15) | How it differs from AirCursor |
|---|---|---|---|---|
| musubipapi/airpointer (AirPointer, by Andy Gao himself) | Open source / macOS | 2026-11-06 | 404 stars, 52 forks (our library: 11-07 168 → 11-08 262) | Original: uses the **closed charging case** as an air mouse, relies on case diagnostic data, cuts audio and burns case data. AirCursor is head control with the earbuds you wear, never touches the case. |
| starman-tech/mousepods(MousePods,Matteo Gaudioso) | Open source / Linux | 2026-11-04 | 469 star(11-06 51 → 11-10 326) | Reverse-engineers the RemoteHID protocol of AirPods 3 on Linux, covered by Hackaday, AppleInsider, Hackster and daily.dev, with the selling point "reverse-engineered with Claude Code". AirCursor uses Apple's public API (CMHeadphoneMotionManager) and is Mac-only. |
| oscarcreatess/airpointer | Open source / macOS | 2026-11-06 | 194 star | Borrows the AirPointer name; its description reads "This is the only REAL Repo", competing with Andy's original for the name. |
| Coolerwave/unmagic-mouse(UnMagic Mouse) | Open source / macOS | 2026-11-06 | 9 stars; but TikTok @coolerwavex video has 1.55M views and 90k likes, and @zar.tech's repost has 270k views. | Tilting the charging case controls the cursor, "built with Claude Code". TikTok traffic barely turned into stars. |
| 0xCodez/PodMouse | Open source / macOS | 2026-11-05 | 7 star | Generated from @0xMovez's Opus 5.5 demo prompt. The README states "pointer mapping based on AirCursor (MIT)", standing directly on AirCursor. |
| JNDZdev/APMouse, tony1010-dev/PodMouse, youn-sm/AirpodMouse, MoYiC6/airpods-mouse, frodo233/airpodsCursor, kuldeepsajnani51-svg/airpods-mouse-bridge (Windows) | Open source | 10-29 ~ 11-09 | 0–7 star | Small repos on the same topic with fewer features, no download package or onboarding |
| gintmr/NodLink | Open source / macOS + iPhone | 2026-11-07 | 3 stars, Sspai ran 11-08 article(s) | Web console + ESP32 hardware approach aimed at accessibility; Sspai covered it domestically |
| drpatel's AirPointer prototype (Reddit r/airpods) | Original | 2026-11-05 | Not open source | Say "click" or pinch-to-click via camera; many comments asking for it to be public |
| willwade/AirpodHeadmouse | Open source / macOS | 2025-10-05 | 13 star | Built the same head-controlled mouse a year earlier, nobody paid attention. Proof that timing matters more than the idea. |
| PodsControlMac(Devpost) | Hackathon | 2026-01 | Very small | Head-controlled cursor + offline dictation, positioned on accessibility |
| ScrollPods | Mac App Store | 2025-11-13 | Free, 0 rating on the US App Store | Head-controlled scrolling only, distributed through the store; recommended twice on Reddit r/macapps |
| Headway (built by a Digital Trends editor) | Built for personal use | 2026-11-10 | Article | Head-controlled page turning/scrolling, unreleased |
| Cogria-AI/HeadOrbit | Open source / macOS | 2026-09-13 | 260 star | Also reads AirPods head motion, but it blurs the screen when you turn your head and reminds you about posture. It's not a mouse. |
| umarz317/WatchPointer | Open source | November | Also mentioned in the same HKEPC and Zhihu pieces | Apple Watch as an air mouse, a variant of the same wave |
| macOS Head Pointer / iOS head tracking | Big-company features | since macOS Catalina (2019) | System level | Built into Apple's OS, but it tracks your face with the **camera** . AirCursor doesn't use a camera, so privacy and lighting aren't limits. |
| SmartNav, Glassouse, Enable Viacam, etc. | Commercial hardware / open source | Years | Niche accessibility market | Needs extra hardware or a camera. AirCursor uses headphones you already own, at zero cost. |

Bottom line: **it is not the first to make an AirPods head-controlled mouse** (willwade did it a year earlier), and **it is not the one with the most stars** (MousePods 469, AirPointer 404). It ranks third among same-topic repos, but in the "wear AirPods on a Mac as a mouse, downloadable directly" slot it is first and also the most complete.

### 3. Growth: where users came from

#### 3.1 Trigger: Andy Gao's charging-case video (confirmed)

- X @instantricecook, 2026-11-04 02:15 UTC: "I turned my airpod case into a mouse and it works pretty well!", 1.5M views, 442 replies (X page read via r.jina.ai). 11-04 22:10 UTC, Indian account Vaibhav Sisinty relayed and spread it.

- Instagram reposts that followed (chatgptricks, creativelyange, Tech Originals, Al Bawaba, 4Gamers Taiwan, HKEPC, etc.) spread "AirPods case as a mouse" as general tech news. YouTube OmniTech Daily made "We Checked the Viral 'AirPods Mouse' Claim", original post 11k likes, and the video treated AirCursor as the real-world version of the viral claim.

- Andy himself didn't publish the AirPointer repo (musubipapi/airpointer) until 11-06. **Between 11-04 and 11-06, people looking for the code found no original version, and AirCursor filled that gap** .

#### 3.2 AI tool repost accounts treated it as the "link" (confirmed)

- Instagram @theaiskool (11-05): "Your AirPods can now control your Mac… Meet AirCursor, an open-source project…", paired with the charging case video's buzz.

- Instagram @creativelyange (Angel, 11-04): first said "I'm vibecoding my own version, comment MOUSE and I'll send the link," then later posts had github.com/m-afham/AirCursor in the caption (Jina search snippet).

- Instagram Tech Originals (around 11-10), Creative Plus (@creative_plusss, "Watch the full video to see how to install the app").

- **Instagram @ishandutta.ai (Ishan Dutta, 28.8k followers, posted 11-13)** : "Follow and Comment 'Code' and I will DM you the link to the GitHub repository!", a classic comment-for-link follower-growth trick. The copy is the same template as the theaiskool post ("AirCursor explores a different approach by turning hardware you already own…"). The timing lines up with 11-14, when the repo got 15 forks and 11-15 stars in a single day (+67 that day), and most of the fork accounts have Indian names. This is an inferred attribution; the stargazer timestamps aren't available (the API requires extra permissions).

- The pattern with these accounts: hook onto a viral video, grow followers with "comment a keyword and get the link via DM," and use the open-source repo as a free lure. AirCursor was picked because it could be downloaded, had a nice README, and advertised "MIT, free, private."

#### 3.3 media and Chinese-language channels (confirmed)

- HKEPC (Hong Kong) 11-05 article headline: "Developer turns AirPods into wireless mouse 'AirCursor', open-source motion mouse project launches," but the body and video are about Andy's charging case. **The media attached the viral video's name to AirCursor by mistake** , syndicated to FB/Threads/IG.

- Zhihu column / RENREN (11-10) / Yunzhan community (11-13), same article "Use your AirPods as a mouse, 3 black-tech GitHub open-source projects": openly says "this post went viral overseas, the author said he'd open-source it later but hasn't yet, so I found a few similar ones," with AirCursor among them. The domestic forks/PRs 11-05 and 11-10 (674019130, Yuxin-Ren-SZ, wufadingyi) line up with this.

#### 3.4 developer-circle "foundation" citations (confirmed)

- X @0xMovez posted a long-prompt demo of Opus 11-05 building a Mac app (5.5, openchamber listed it as an Opus 5.5 video), explicitly writing "Credit m-afham/AirCursor (MIT) as the base of the pointer mapping"; the README of 0xCodez/PodMouse also notes it's based on AirCursor.

- The kvx07/iphonehandmouse README lists AirPointer (the case), AirCursor (Mac head control), and MousePods (Linux) as three "good AirPods-as-a-mouse projects." In developers' eyes, it already represents this category.

#### 3.5 what I didn't find

- Hacker News (our hackernews database, last 30 days): no posts about AirCursor, AirPointer, or MousePods.

- Reddit: r/airpods has the original charging-case post (deleted) and drpatel's head-control prototype post; r/AppleEcosystem and r/projects have "Using Airpods as a Mouse on Mac." The content is blocked by Reddit, so I can't confirm whether they mention AirCursor.

- No records in the X local corpus (x-radar); the author has no X account and didn't post themselves.

- TikTok (TikHub search for "AirCursor" and "airpods mouse"): what went viral was UnMagic Mouse (1.55M views) and AirPointer reposts (github.signals 16k). No videos directly about AirCursor turned up.

- No evidence of ads, Product Hunt, or celebrity shares.

### 4. Why it took off

1. **A demand-before-supply gap** : the charging case video, 1.5M views, created a big wave of "I want this too, where's the code?" demand. The original author didn't open-source until two days later; AirCursor had a downloadable build within 20 hours of 1.0.

2. **Works, installs easily, looks good** : the README has a big "Download for Mac" button at the top, animated screenshots, and a one-minute setup guide (nod-amplitude self-calibration, real-time head mirroring on 3D headphones). Hover-click only applies to clickable controls, and a diagnostics panel checks each link in the chain. For repost accounts, this is the best link to hand over; for ordinary users, it actually works after download (about 1,700 zip downloads).

3. **Uses public APIs, low risk** : it reads worn headphones through CMHeadphoneMotionManager, unlike AirPointer, which has to cut audio and drains the case's diagnostic data, and unlike MousePods, which reverse-engineers the Bluetooth protocol. It supports the full AirPods Pro line, Max, 3 generation, and Beats Fit Pro, a wide range of devices.

4. **Wrong attribution amplified it** : HKEPC and others named the charging case video directly as AirCursor, and the repost accounts' template copy tied it to the charging case hotspot.

5. **A second wave from the "comment for the link" accounts** : 11-13 Ishan Dutta's reel brought 11-14/15 (forks +15, stars +67), with sources concentrated in India.

6. **Engineering credibility** : MIT license, no analytics, only connects to GitHub to check for updates, verifies update packages with Ed25519, and a long write-up explains the TCC permission pitfalls. Developers take it as a foundation (PodMouse and others) rather than just looking at the buzz.

### 5. Differentiation, and whether that's why it took off

- Differentiation: **head control with worn AirPods + a native menu bar app + one-click download + a complete click scheme (hover-click, nod, pinch the stem for single/double/triple tap, shake head to pause, tilt for custom actions)** . Competitors at the time were either case-held (AirPointer, UnMagic Mouse, with audio-cut risk and more of a toy feel), Linux (MousePods), or half-finished builds with no installer. Apple's built-in Head Pointer uses the camera.

- Is it the main reason? **Partly.** The root cause of its growth was timing: it rode someone else's viral video and filled the gap before the original went open-source. Differentiation (polish and downloadability) is why, among a dozen repos on the same topic, repost accounts, media, and listicles picked this one. But its star count is capped by the fact that "head-control mouse" is itself a novelty toy: the original AirPointer overtook it at 2 times the speed once released, MousePods earned mainstream tech coverage with the "reverse-engineered protocol + Claude Code" story, and AirCursor never got a feature in any major English tech outlet.

### 6. Visibility and copycats

- Visibility: **circulating in small circles** . It's free and open-source with no revenue; there's no major English media feature, no HN post, and the author has no social accounts. Spread came mainly through IG repost accounts, HKEPC, and Chinese listicles. The buzz nominally belongs to Andy Gao's charging case video, and AirCursor was the one mentioned in passing.

- The copycats: 0xCodez/PodMouse (explicitly based on AirCursor), youn-sm/AirpodMouse, tony1010-dev/PodMouse, JNDZdev/APMouse, kuldeepsajnani51-svg/airpods-mouse-bridge (Windows), 11-14 plus a batch of forks and renamed forks from Indian users (Abhinandandg/Abinandan-s-Mind-Cursor, manwithb9/Abhinandan-MindCursor). The topic spawned 15+ repos in a single week.

### 7. Takeaways

- **"Viral demo → original author doesn't open-source → full downloadable version delivered within 24 hours"** is a replicable play: watch X/TikTok for hardware/interaction demos with "please open-source" comments, use Claude Code to build a version with an installer and setup guide within a day, and title it with the phrase from the hotspot ("Your AirPods are now a mouse").

- The README as landing page: a big download button, screenshots, and the "privacy / MIT / free" trio is what the IG "comment for link" accounts love to pick up. These accounts distribute for you on their own, and in multiple waves (11-05 one wave, 11-13 another).

- Using public APIs instead of reverse engineering means wider device coverage and fewer pitfalls; users can install and use it right away, so word of mouth is steady.

- Counterpoint: the TikTok hit (UnMagic Mouse, 1.55M views) brought no stars, showing GitHub stars come from channels that have a clickable link (IG DM links, Chinese listicles, developer citations), not from view counts.

- Ceiling: head-control mice are a novelty. The real long-term need is accessibility (upper-limb disabilities, RSI). To scale, you'd have to position for accessibility, build Windows/Linux versions, or go paid distribution outside the App Store. Nobody has done that yet.

### 8. Uncertain

- The exact source of 11-15 single-day +67 stars: stargazer timestamp endpoints require permissions, so they can't be retrieved. The concentrated Indian-account forks coinciding with Ishan Dutta's 11-13 reel is an inference.

- View counts and likes for each Instagram reel couldn't be retrieved (not logged in, only partial data shows). Follower counts for theaiskool and Tech Originals haven't been verified.

- Whether the author started building before Andy's video: the first commit was 11-04 22:20 UTC, 20 hours before the video, and it was already quite complete by 1.0. Prior groundwork or heavy AI generation isn't ruled out (the author's site says it was built with Claude Code).

- The r/AppleEcosystem and r/projects Reddit posts were blocked, so whether they promoted AirCursor is unverified.

This article was written by AI from public data and the data we collect daily. Numbers are sourced, and inferences are labeled.
