# "Request it and someone will adapt it": a small tool that shows mouse battery level, with only 200 stars but 20k downloads · GitHub open-source project

> Source: https://stringers.io/en/github/gh_wushuai0802__myfinder-device-battery.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

> In mid-October a wave of DIY battery tools hit Bilibili. This one had 11-03, plus in-app feedback with no GitHub account needed and one-click updates. The author used AI to ship test builds per model within hours. Users submitted a model and someone added support, so they stayed, and they brought in others with the same devices.

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

wushuai0802/myfinder-device-battery · wushuai0802

# "Request it and someone will adapt it": a small tool that shows mouse battery level, with only 200 stars but 20k downloads

**What it is** A Mac-style battery card for Windows that shows how much charge is left on domestic 2.4G devices like Attack Shark, Wolf Spider and Rapoo mice, keyboards and headsets, without installing vendor drivers that take hundreds of MB.

**Why it blew up** In mid-October a wave of homemade battery-meter tools hit Bilibili. Each one 11-03 paired with no-GitHub-account in-app feedback and one-click updates. Authors used AI to ship beta builds per device model within hours, and users who asked for support got it, so they stuck around and pulled in others with the same hardware.

**C** **How you could follow it** Stop making the Windows version. The macOS projects that read 2.4G peripheral battery levels are all single-brand with single-digit stars. Build a multi-brand version, bring over the account-free feedback plus automatic issue creation pipeline, and launch with a Bilibili demo video.

Grade C: Windows versions of this type appeared by the dozens over three weeks, and the most-starred same-category repo has only 746 stars. The peak had passed by late October. Its edge is that the author adapts a new device every day, which earns users, not stars. Copying the approach doesn't guarantee the same star count. Only the multi-brand macOS gap looks worth a try. Few people know about this yet

Data (updated daily) · Repo created 2026-10-16 · 359 stars · 7 days +152

GitHub · stars

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

MyFinder Device Battery is a small Windows tool that shows battery levels for wireless mice and headsets. In mid-October a wave of homemade peripheral battery tools swept Bilibili, and it entered late. It has few stars, 11-12 is 204, but its release packages have about 21.7k downloads and nearly 500 in-app feedback submissions, more than most of its peers. Its strength is a pipeline where users send feedback in one click and the author ships an adapted build the same day. For developers who want stars, this route gets you users, not so much stars.

### One issue, 24 hours

At 2:30 p.m. Beijing time on Nov 5, a user named JOJO2066 clicked "Feedback" in the app: "rapoo 雷柏 VT3 双 8K version not recognized." He never opened an issue. The app filed it on GitHub for him, with the receiver ID and interface list attached.

55 minutes later the author replied; another 50 minutes after that, test build 1.3.8-beta.5 added the Rapoo VT3 series. Still no reading. A user timed their mouse with a stopwatch and found it reports battery only every 30～60 seconds, and the author changed the code to match and shipped the official 1.3.8 that same day. Still no reading. That night another user, Plaudern, modified the code locally to read the VT3S and pasted the report format into the thread. From that the author found the root cause (Windows exposes Rapoo's battery report as an array of button entries, and the program's length check rejected it), and at 2 a.m. shipped beta.2, which added 69 wireless model IDs from the Rapoo driver in one go. The next morning it still didn't work, so the author first posted a diagnostic build that clearly logs "where it's stuck", then shipped beta.7 after getting the diagnostics back.

On Nov 6, at 2:39 PM, JOJO2066 replied with a screenshot: "Thanks a lot, wireless mode now reads correctly." Within 24 hours, this one issue went through seven or eight beta builds. Also on 11-05, the author wrote in the thread that the in-app feedback had hit its "daily limit today."

### What it is

A macOS-style battery card: a tray icon with a popup panel showing how much charge is left on the 2.4G wireless mouse, keyboard, and headset. The name comes from MyDockFinder, the 24 Steam app that makes Windows look like a Mac, and this tool was originally a widget for it. The repo description still reads "ATK Mouse & HyperX Headset": it started as something the author wrote for his own mouse and headset.

What it actually does is reverse-engineer the protocols of Chinese peripheral receivers, one device at a time. It's read-only, never writes to the device, and marks anything it can't read reliably as "≈ / to be confirmed" instead of inventing a 100% figure. Each release note in the README has lines like "#535 #536... grade C, pending real-device testing." Written in Python, AGPL open source, free, and the commit history includes "Generated with Claude Code."

### Why now

The demand was always there. Windows only shows battery for Bluetooth devices. A mouse on a 2.4G receiver never shows up, so to see its charge you have to keep the vendor driver running, and those drivers often run from hundreds of MB to 1GB.

The spark was Bilibili. The review by 什么值得买 11-05, "Wireless mouse battery feels like a blind box? Homemade tools from players now show it all at a glance," reads: "Starting mid-October, a wave of homemade tools that check battery levels flooded Bilibili." The lead was UP creator 硅基SZ酱's "A software that shows the battery of any 2.4G peripheral," with 380k plays and 16k favorites, open-sourced along with its AI prompt. AI squeezed "reverse-engineer an HID protocol, write a tray app" into a single weekend, and dozens of similar tools appeared within three weeks. The review name-checked five or six of them, but not MyFinder.

MyFinder had its repo up by 10-16, but it stayed quiet until 11-03. Up through 1.3.4 and earlier, each release got only 2～6 downloads (GitHub, 11-12). The similar projects peaked in daily star growth between 10-20 and 10-28; MyFinder's peak came between 11-04 and 11-06, a beat later.

### What it added in Nov 3

1.3.5 formal release (11-03) added three things at once: in-app feedback (no GitHub account needed), one-click updates with signature verification, and tray grouping with four color themes. The same day, the author created a feedback relay repo: feedback submitted from the app was automatically turned into GitHub issues, and a bot applied triage labels: "Data package possible," "New vendor," "Already supported," "Insufficient evidence."

After that came a closed loop: a user clicks feedback, the relay opens an issue, the bot triages it, the author ships a test build against the issue number, and the app checks for updates every 6 hours; formal-release users also get notified of test builds by default. In "My Feedback," users see the author's replies and can add more info. From 1.3.7 it also added "model data packs," so new models using the same protocol work without a new app version.

The numbers grew with it (GitHub, 11-12):

| Version | Date | Downloads |
|---|---|---|
| 1.3.4 and earlier | 10-17–10-31 | 2～6 downloads per release |
| 1.3.5 | 11-03 | 4,532 |
| 1.3.7 | 11-04 | 2,091 |
| 1.3.8 | 11-05 | 3,606 |
| 1.3.9 | 11-06 | 3,781 |
| 1.3.10 | 11-10 | 931 |

All versions combined come to about 21.7k downloads, and the model data pack was pulled about 10.6k more times. Many of these are repeat counts from existing users auto-updating; the real active user base is probably four to five thousand (inference). There are 523 issues in total, 498 of them from in-app feedback. 11-05 opened 169 in one day, and the author commented on 496 of them. Over three weeks: about 70 releases and 284 commits.

Stars are a different story. 11-05 has 89 stars, and 11-06 added 69 in a single day, the most of any day, and 11-12 to 204,7 days added 113, first among similar projects this week. But stars are only about 1% of downloads: most people who file feedback are peripheral players who have never logged into GitHub, and starring requires making an account first.

### Where users came from: unclear

The first few thousand people poured in around noon Beijing time on 11-04, through an entry point that was never verified.

- A Xiaohongshu account with 8 followers posted two notes at 8:30 11-04 morning, both titled with the repo name: "#ai simple plugin, solves the driver redundancy headache". 31 likes, 43 saves. The timing lines up, but the volume can't account for thousands of downloads.

- Bilibili has no videos dedicated to it. Authors of similar tools commonly drop their GitHub link in the top comments of big videos (the pinned comment on 2.4G-battery-viewer has 962 likes), and I couldn't find MyFinder doing that.

- Smzdm, X, Hacker News, and V2EX don't mention it, and MyDockFinder's official Steam announcements don't either.

The more likely path is word of mouth through QQ groups, Tieba, and Bilibili comment sections (inference). What's confirmed is the second half: once people arrived, "report it and someone will adapt it" kept them around and got them to bring in others with the same devices.

Judging from the feedback titles, the people arriving aren't MyDockFinder's skin users but Chinese peripheral players: Maxtoo 71, Wolf King 43, Pro Walker 35, Rapoo 21, VGN 21, ATK 16.

### Who it's competing with

Numbers from GitHub, as of 11-11:

| Project | Scale | Compared with MyFinder |
|---|---|---|
| HaloBattery | 746 stars, 14.6k downloads | Launched 9-25, most stars in its category; 2.4G and Bluetooth both supported, leans toward a taskbar number, no account-free feedback |
| VigilWatt | 180 stars, 51k downloads (highest in category) | Desktop widget open-sourced by a Xiaohongshu blogger, more downloads than MyFinder; models aren't tracked one by one |
| 2.4G-battery-viewer (硅基SZ酱) | 266 stars, Bilibili videos with 380k views | Zero dependencies, ships an AI prompt so users can have AI modify it; the author doesn't maintain each device |
| FerrisPulse (灵脉) | 223 stars, 3,156 downloads | Positioned as a replacement for 500MB's Razer software, leaning toward Razer, Logitech, and Rapoo |
| Voltide | 111 stars, 2,555 downloads | 10-30 launched, also updating by model, the closest rival |
| A dozen or so single-brand tools | each 5～142 stars | Each covers one brand only, such as Inphic, MCHOSE, or ATK, or Bluetooth only |
| EasyBluetooth | Paid | Supports dozens of brands and hundreds of devices, with a game overlay |
| Vendor drivers, Windows Bluetooth battery | full range | Drivers are heavy; Windows doesn't read 2.4G; the new battery widget Microsoft showed at its October event hasn't shipped |

The space is already crowded. Compared with these, MyFinder's code isn't special. What sets it apart is that the author is willing to adapt device by device and has made that process semi-automatic.

### What you can learn

- **Let people who don't know GitHub open issues for you.** The app submits a structured, anonymized diagnostic with one click; the relay service opens the issue on the user's behalf, and the bot triages it. The issue tracker becomes a crowdsourced test platform, and devices the author doesn't own can still get supported.

- **Adaptation data ships separately from the app.** Model data packs are delivered online, so new models don't require a release.

- **Long-tail hardware plus a gap in the OS is a template you can reuse.** Anywhere the OS ignores the category, vendors do a poor job, and models are numerous and scattered (gamepads, headsets, UPS units, power banks, local peripheral brands in various countries), this approach works.

- **This approach brings in users, not stars.** The users are ordinary players, and they don't star repos. HaloBattery, the most-starred in its category, has only 746 stars.

### If it were you

**One judgment call:** You can learn from it, but copying it isn't very worthwhile. Dozens of peripheral battery tools appeared on Windows in three weeks. The wave crested in late October, and MyFinder's feedback fell from 11-05 of 169 issues to 11-11 of 19. The star ceiling for this category is a few hundred.

**Who it suits:** People with a pile of peripherals from different brands who are willing to maintain them device by device over the long term, or people who want to practice the pipeline of "account-free feedback → auto-issue → AI-drafted patch" and plan to port it to other hardware categories.

**Who it doesn't suit:** People hoping a single weekend project will pull in thousands of stars. This category's users aren't on GitHub, so star counts won't climb. Anyone unwilling to check issues every day won't get MyFinder's results.

**How to do it:** Don't build another Windows version. The gap is on macOS: the GitHub projects that read 2.4G peripheral battery on Mac are all single-brand, one each for JD JINGZAO, Lofree, Newmen, and VGN, with 0 to 10 stars. Plenty of people use a Mac with a Chinese 2.4G receiver plugged in, and the system still shows no battery. Build a multi-brand menu bar and desktop widget, and carry over MyFinder's protocol notes and feedback relay (note that it's AGPL, so borrowing the code means open-sourcing yours under the same terms). The other route is to switch categories: gamepads, wireless headset docks, UPS units, using the same feedback pipeline to pick up the long tail.

**How to get users:** Follow 硅基SZ酱's playbook: post a Bilibili demo titled something like "Check your 2.4G mouse battery on a Mac," with the app and prompt open-sourced together, then drop the link in the comments of the big videos from this battery-tool wave. People searching "mouse battery" on Xiaohongshu are also target users. Name the supported brands and models in the README so they show up in search.

**When the window closes:** On Windows it's already late. On macOS there's a window until Microsoft or Apple build the feature into the OS, but the Bilibili wave will probably fade by year-end (inference).

**What would show you've misread it:** If the new Win11 battery widget reads 2.4G receivers once it ships, the reason for Windows tools of this kind disappears across the board. If someone builds a multi-brand Mac version, posts a video, and only gets a few dozen stars, then demand on Mac is smaller than estimated.

[GitHub repo ↗](https://github.com/wushuai0802/myfinder-device-battery)

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

Competitors

| Name | Where | Launched | Scale | How it differs from this one |
|---|---|---|---|---|
| HeyOkay/HaloBattery | Open source | 2026-09-25 | 746 stars, release downloads 14,561 | Earlier and more stars; 2.4G + Bluetooth taskbar indicator; no Mac-style card or account-free in-app feedback loop |
| evren-oct/vigil-watt(VigilWatt) | Open source | 2026-10-17 | 180 stars, release downloads 50,980 (highest in category) | Desktop widget open-sourced by a Xiaohongshu blogger, more downloads; no device-by-device feedback-to-adaptation pipeline |
| yszyszysz233/2.4G-battery-viewer (硅基SZ酱) | Open source | 2026-10-17 | 266 stars; Bilibili video with 380k views and 16k favorites | Zero dependencies, ships an AI prompt so users modify it themselves; the author doesn't maintain each model. MyFinder has the author adapting devices for users. |
| Ferris-echo/FerrisPulse (灵脉) | Open source | 2026-09-12 | 223 stars, 3,156 downloads | Positioned as a replacement for Razer's software, leaning toward Razer, Logitech, Rapoo, and NuPhy; MyFinder leans toward Chinese 2.4G long-tail brands like Maxtoo, Wolf King, Pro Walker, VGN, and ATK |
| sdparklab/Voltide | Open source | 2026-10-30 | 111 stars, 2,555 downloads | Still actively updated and adapting per model, the closest rival. But it has no account-free feedback channel and no device data packs |
| QuickBuds / Power-Sentinel / EZ2.4G / quiet-battery / InphicBatteryTray / mchose-battery-tray / mouse_tray and others | Open source | 2026-06–10 | each 5～142 stars | Mostly single-brand or Bluetooth-only |
| EasyBluetooth | Other | Earlier than 2025 | Paid, dozens of brands and hundreds of devices (SMZDM) | Paid; MyFinder is free and open source (AGPL) |
| Vendor drivers (Mchose HUB, ATK HUB, Razer Synapse, G HUB) | Other | Has been around all along | One brand each | Several hundred MB to 1GB, must run in the background; MyFinder is meant to replace exactly these |
| Windows Bluetooth battery levels / Win11 new battery widget | Big-company features | Already available / shown at the 2026-10 launch event | full range | Bluetooth only, doesn't read the 2.4G receiver; widget not shipped yet |
| MyDockFinder includes Bluetooth battery display | Other | Already there | A ¥24 Windows beautification app on Steam | Only shows some Bluetooth devices; MyFinder covers the 2.4G side |

Where users come from

- **Verified** **In-app feedback + auto-update (retention and return visits)** : from 1.3.5 (11-03) onward, users can submit feedback without a GitHub account and see the author's replies under “My Feedback”; the app checks for updates every 6 hours. 498 in-app feedback items; the author has commented on 496 issues. 1.3.8 / 1.3.9 have about 3,700 downloads each, most of them likely auto-updates.

- **Verified** **Xiaohongshu user notes** : two posts by “胖子不会水” on 11-04 08:36, with 31 likes and 43 saves. The reach is far too small to explain several thousand downloads.

- Inferred **Word of mouth via comments on similar Bilibili videos and QQ groups** : authors of similar tools commonly pin their GitHub links in top video comments (the pinned comment on 2.4G-battery-viewer got 962 likes). No MyFinder link or dedicated video was found.

- **Verified** **Passive indexing by aggregator sites** : kaiyuanbang.cn, reporank.net, repositorystats.com

- Inferred **Media / X / HN / MyDockFinder official channels** : The SMZDM roundup, x-radar, V2EX, and the Steam announcements don't mention it.

## wushuai0802/myfinder-device-battery (MyFinder Device Battery) research report

Data as of 2026-11-11/12. Sources: live GitHub API queries (stars, release download counts, issues, forks), our github database (repo_profile / repo_day), Exa / Jina / Brave search, TikHub (Xiaohongshu, Bilibili), and the original SMZDM article.

### One line

A macOS-style wireless peripheral battery card for Windows (tray icon + pop-up panel), originally built as a companion widget for MyDockFinder, a ¥24 “make Windows look like a Mac” beautification app on Steam. What it actually does: reverse-engineer the HID protocols of Chinese 2.4G keyboards, mice, and headset receivers, one device at a time, and read battery levels in read-only mode.

### Verdict

It is one of the **very late entrants** in the “mid-October Bilibili peripheral battery tool wave.” What lets it beat its rivals isn't stars but a **closed loop for retention and device support** : one-click in-app feedback (no GitHub account needed) → a relay service auto-creates GitHub issues and triages them → the author uses AI (commits are signed “Claude Code”) to ship beta support per model within hours → the app auto-checks for updates every 6 hours, and device data packs take effect without a program update → users get their battery readings and keep using it. So it has fewer stars (203) than similar tools but more users than most: about 21.7k release downloads, plus 10.6k device-pack pulls; 498 in-app feedback items; and the author has commented on 496 issues. Where the users came from is unverified. What is clear: almost nobody used it before 11-03, and users surged in starting around noon 11-04 (Beijing time).

### 1. The data: how it took off

| Metric | Numbers | Source |
|---|---|---|
| Star | 11-05 89 → 11-06 158 (+69, the single-day peak) → 11-12 202 | Our github database repo_day (11-05 is the first observation; there was no daily data before that) |
| 7-day star gains | +113, first among similar tools this week (HaloBattery +24, FerrisPulse +22, Voltide +34, 2.4G-battery-viewer +17) | github library repo_profile |
| Release downloads | 21,720 downloads across all versions (excluding device-pack); 10,588 for device-pack | GitHub releases API,11-12 |
| Download timeline | 1.3.4 and earlier (10-17～10-31): each release had only 2～6 downloads. 1.3.5 (11-03): 4,532 downloads. 1.3.7 (11-04): 2,091 downloads. 1.3.8 (11-05): 3,606 downloads. 1.3.9 (11-06): 3,781 downloads. 1.3.10 (11-10): 931 downloads. | Same as above |
| Issue | 523 issues in total (excluding PRs), 498 tagged in-app-feedback. By day: 11-03 on 10, 11-04 on 55, 11-05 on 169, 11-06 on 112, then dropping to 19～43 a day. 91 closed. | GitHub issues API |
| Author involvement | The author commented on 496 issues and submitted 284, concentrated on 11-03～11-06 (35～52 a day). | GitHub search / git log |
| Triage labels | pack-candidate 223, new-vendor 176, supported 65, insufficient-evidence 45 | Issue labels (auto-applied by github-actions) |
| User device brands (roughly counted from issue titles) | MhelloGo 71, Wolf King 43, Vanguard 35, Rapoo 21, VGN 21, ATK 16, ROG 13, gamepads 13, MCHOSE 11, Razer 9 | Issue titles |

My read:

- **11-03 is the dividing line.** That day it shipped 1.3.5: in-app feedback, one-click signed updates, tray grouping, and four color themes. The feedback relay repo `myfinder-feedback-relay` went up the same day (created 11-03 05:48 UTC). Before that, it was the author's own “ATK mouse + HyperX headset” utility, and the repo description still reads that way.

- **Users flooded in around 11-04, 12 Beijing time.** In-app feedback by hour: 11-04 04～08 UTC, 3～10 items per hour; 11-05 all day, 6～15 items per hour.

- **Stars and users are off by an order of magnitude.** 202 stars against 20k+ downloads and nearly 500 feedback items. Stars are only about 1% of downloads. The reason is that feedback doesn't require a GitHub account, so most users are ordinary peripheral enthusiasts who have never used GitHub. On 11-06 it gained +69 stars, the same day as the 1.3.9 stable release and the peak in issues.

- **The users aren't MyDockFinder's audience, they're Chinese peripheral enthusiasts.** Feedback clusters around domestic 2.4G brands like Mchose, Wolf King, Vanguard, VGN, and Rapoo. MyDockFinder in the name reflects its origins, not where the users came from.

### 2. Timing: it caught a whole wave of “peripheral battery tool” buzz

- SMZDM's 2026-11-05 roundup “Wireless mouse battery like a blind box? This wave of homemade tools, all in one view” (https://post.smzdm.com/p/awwd9z5g/) writes: “From mid-October, a string of homemade ‘check battery’ tools flooded Bilibili.” The lead was Bilibili UP host 硅基SZ酱's video “A software that shows the battery of any 2.4G peripheral” (BV16AJb6aEpC), with 380k+ views and 16k+ favorites. The program and prompts were open-sourced together (corresponding to yszyszysz233/2.4G-battery-viewer). The article also names FerrisPulse, Big Fat Fish, Voltide, VigilWatt, and EasyBluetooth, but **does not mention MyFinder** .

- The root need: drivers for domestic peripheral brands run from several hundred MB up to 1GB, and you can't see battery levels once the driver is closed. Windows only shows battery levels for Bluetooth devices, so anything on a 2.4G receiver never appears. The SMZDM article notes that Microsoft showed a new battery widget at the Win11 October launch event, but it hasn't shipped yet.

- AI has cut the cost of “reverse-engineer an HID protocol and write a tray app” to a single weekend, which is why dozens of similar projects appeared within three weeks (see the competitor table). MyFinder's commits carry “Generated with Claude Code,” and the author's other repos are AI tools like Codex and Claude usage monitors, so this is a heavy AI-assisted developer.

- **It created the repo 10-16, but didn't release anything publicly before 11-03.** By the time it entered with feedback and update features, the crest of the wave had passed: similar tools peaked in daily star growth on October 10-20～10-28, while MyFinder was in 11-04～11-06.

### 3. Growth tactics: where the users came from (evidence)

| Channel | Evidence | Confirmed? |
|---|---|---|
| Xiaohongshu user notes | “胖子不会水” (Anhui, 8 followers) posted two notes titled “Myfinder-device-battery” on 11-04 08:36 (Beijing time): “#ai a simple plugin that fixes driver clutter,” with 31 likes, 43 saves, and 5 shares. One comment reads “can't find it in search” (TikHub Xiaohongshu note details). | Confirmed to exist, but far too small to explain several thousand downloads. |
| Bilibili | Searched Bilibili for myfinder-device-battery / MyFinder battery / peripheral battery MyDockFinder: no video dedicated to it turned up, and it isn't linked in the top comments of the two similar videos from 硅基SZ酱 and 談笑间ZH. Creators of similar tools usually drop their GitHub in the top comment of big videos (2.4G-battery-viewer's pinned comment got 962 likes; InphicBatteryTray, MousePowerTray and mchose's tray all do this). Haven't checked whether MyFinder does. | Unconfirmed |
| SMZDM / media | The 11-05 roundup doesn't mention it. | Confirmed absent. |
| X / HN / V2EX / linux.do | x-radar: 60 posts in the last 0 days. V2EX, linux.do, and nodeseek: no results. | Confirmed none |
| In-product mechanisms (retention and return visits) | From 1.3.5 onward, in-app feedback requires no GitHub account. “My Feedback” shows maintainer replies. The app checks for feedback replies and updates every 6 hours. Stable users also get beta notifications by default. Device data packs can be delivered online. | Confirmed (README, CHANGELOG) |
| Aggregator sites | Listed on kaiyuanbang.cn, reporank.net and repositorystats.com | Confirmed: passive listing only |
| MyDockFinder official | Neither the Steam announcements (1.19 / 1.19.1) nor the official usage guide mention it | Confirmed absent. |

Verdict: **we could not trace the entry point for the first few thousand users.** The timing (11-04 noon) lines up with Xiaohongshu posts, but those posts' engagement can't account for this many downloads. More likely it spread by word of mouth in QQ groups, Bilibili comments or Tieba, which we can't search. Unverified. What we can confirm is that it **kept and amplified** that audience: about 70 versions shipped in 3 weeks, with 1.3.8 / 1.3.9 downloads each in the 3,600–3,800 range, mostly likely existing users auto-updating.

### 4. Competitors

| Name | Where | Launched | Scale | How it differs from MyFinder |
|---|---|---|---|---|
| HeyOkay/HaloBattery | Open source | 2026-09-25 | 746 stars, release downloads 14,561, open issues 134 | Earliest in its category and the most stars, 2.4G + generic Bluetooth. Focuses on taskbar indicators, with no Mac-style cards or in-app feedback |
| evren-oct/vigil-watt(VigilWatt) | Open source | 2026-10-17 | 180 stars, release downloads 50,980 (highest in category) | Open-sourced by a Xiaohongshu blogger, with a desktop widget and device list. More downloads than MyFinder, but no per-model feedback-and-fix loop |
| yszyszysz233/2.4G-battery-viewer (硅基SZ酱) | Open source | 2026-10-17 | 266 stars; Bilibili video with 380k views | Pure ctypes, zero dependencies, ships an AI prompt so users modify it themselves. A teach-a-man-to-fish approach; the author doesn't maintain models one by one (9 open issues) |
| Ferris-echo/FerrisPulse (灵脉) | Open source | 2026-09-12 | 223 stars, 3,156 downloads; Bilibili video with 16k views | Razer, Logitech, Rapoo, NuPhy and others. Positioned as a replacement for 500MB Razer Synapse |
| sdparklab/Voltide | Open source | 2026-10-30 | 111 stars, 2,555 downloads | 8.8MB; Attack Shark, Tecware, ROG, Razer, Xbox. Still actively updated, the closest rival |
| spizganed/QuickBuds, oucdc/Power-Sentinel, Ap0LoG1zE/EZ2.4G, TheWebDog/quiet-battery, Tan-TanZi/InphicBatteryTray, marsuyone/mchose-battery-tray, Fan4Metal/mouse_tray and more | Open source | 2026-06–10 | each 5～142 stars | Most cover a single brand (Inphic, MCHOSE, ATK) or only Bluetooth |
| EasyBluetooth | Windows paid software | Earlier than 2025 | Smzdm says it supports dozens of brands and hundreds of devices | Paid; can hook into RTSS / AIDA64 overlays |
| Vendor drivers (Attack Shark HUB, ATK HUB, Razer Synapse, G HUB, etc.) | Vendor software | Has been around all along | One per brand | A few hundred MB to 1GB, and you have to keep them running to see battery levels. Replacing these is exactly what MyFinder sets out to do |
| Windows' built-in Bluetooth battery display; Win11 new battery widget | Big-company features | Bluetooth battery display has long existed; the widget was shown at the 2026-10 launch event | full range | Bluetooth only, doesn't read the 2.4G receiver; widget not shipped yet |
| MyDockFinder includes Bluetooth battery display | Host software | Already there | Steam 24 yuan | Shows only some Bluetooth devices and ignores 2.4G; MyFinder fills that gap |
| Similar tools on the Microsoft Store (peripheral battery managers, Bluetooth battery tray apps, etc.) | Other | Already there | Not verified | Shows the gap is monetizable; MyFinder is free and open source (AGPL) |

### 5. Differentiation

1. **It turned feedback into a fix pipeline (the main reason).** One-click diagnostic submission from within the app: VID:PID, HID usage, reader status, sanitized, no GitHub account needed. A relay service opens the issue automatically, and github-actions applies a first-pass triage label (data package / new vendor / already supported / insufficient evidence). The author ships beta builds by issue number, and the README notes each version as "#xxx grade C, pending hardware verification". Users can see replies under "My feedback" and retry after updates, which feels like being heard. Rivals either make users open GitHub issues (ordinary players won't) or hand users a prompt to get an AI to fix it themselves.

2. **Coverage of the long tail of domestic 2.4G keyboards.** MonsGeek, Attack Shark, Lenovo-style brands, VGN, Rapoo, ATK / VXE, Inphic, Bamboo Bird, Waterfall, Lingbao, CHERRY, ROG, HyperX, Razer…… Each one gets a strict read-only protocol keyed to its receiver PID. If a read isn't reliable, it's marked as "≈ / to be confirmed" instead of guessing 100%. The "model data pack" lets new models that use the same protocol work without a program update.

3. **Mac-style look plus MyDockFinder integration.** Glacier-blue cards, four color themes, DPI switching, audio and headphone output switching. It looks nicer than rivals' plain tray numbers. This is where its original positioning and name came from, but by the brand breakdown of feedback, it isn't the main reason users came.

4. **Engineering credibility.** Signed one-click updates, install transactions with rollback, and read-only with no firmware writes. For users nervous about running third-party tools that read their peripherals, this eases concerns.

Is this why it took off? **Entries 1 and 2 are the ones.** Its stars trail HaloBattery and 2.4G-battery-viewer, but the 500 recent feedback items, 20k+ downloads and the top weekly star gain in its category all come from one loop: request a fix, and someone ships it. Entry 3 is just the hook.

### 6. Visibility and copycats

- **Visibility: almost nobody knows about it yet.** No media mentions, not covered in the 什么值得买 roundup, nothing on X / HN / V2EX, no dedicated Bilibili video, and only two Xiaohongshu user notes with a few dozen likes. Only aggregator sites index it. It's open source and free, with no revenue. But its category is already crowded: dozens of similar tools, including videos with 380k views and a 什么值得买 roundup.

- **Copycats:** There are forks that ship their own builds, such as zhangleoxue-blip/myfinder-device-battery ("LeoZhang build") and SpiritualHeart/device-battery-view, a renamed fork. Another 17 forks were mostly created between 11-04 and 11-11, mainly users adjusting models for themselves. wuxiena/batt-tray (created 10-24, 1 stars) is a parallel project from the same period, not a copy.

### 7. What's worth borrowing

- **Using a open-source project's issue tracker as a crowdsourced test platform.** Ordinary users who can't use GitHub submit structured diagnostics from inside the app. A relay service opens the issues for them, a bot triages them automatically, and the maintainer uses AI to produce compatible builds in bulk. That builds real users and data even without many stars.

- **Separating the "model data package" from program updates,** so supporting new models doesn't require a release.

- **Long-tail hardware compatibility (small-brand peripherals, controllers, earphones, UPS units, power banks...) plus system-level capability gaps** . This template can be reused for other device categories and language markets, like local peripheral brands in Japan, Korea and Southeast Asia, or reading 2.4G devices on macOS.

- The space is already crowded, and AI lets a rival tool be built in a weekend. The real barrier is **the willingness to keep maintaining models one by one, and the pipeline behind it** , not the code itself.

### VIII. Unknowns

- Where the first few thousand users came from (QQ groups? Bilibili comments? Tieba? The MyDockFinder community?) — no direct evidence found. 11-04

- GitHub's stargazer detail API returns 404 for this repo, so we couldn't get per-star timestamps. Our tracking for this repo only starts at 11-05, so the star curve before 11-04 is unknown.

- We can't separate new installs from auto-updates in release downloads. Active users are roughly estimated at 4–5 thousand, unverified.

- The README marks many models as "grade C, pending hardware verification", so the actual read success rate is unknown. Also unknown: whether the author can keep maintaining it if feedback volume drops.

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