Send anonymous usage data with no identifier, on by default with a clear notice and a one-click off

Open
#724 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
macos, swift
Domain
desktop

Research direction

Start with Sources/StableBar/BugReport.swift for the existing Mac facts and configuration summary, then read the Settings → General implementation, setup flow, docs/, and DECISIONS.md. The issue leaves the report destination, legal review, and whether to publish totals open, so those decisions need resolution before implementation. Done means consent notices and controls, identifier-free daily reports, updated privacy text and decision record, and release notes are in place.

Written by the indexing model from the issue text.

Description

enhancement

Problem

We decide what to build, test and keep without knowing how StableBar is used: which macOS versions people run (macOS 27 broke clicks on the bar, #366, and Menu bar items, #372), how many use AeroSpace, yabai, OmniWM or macOS Spaces, how many keep the bar below the menu bar instead of replacing it, how many displays and notched screens they have, and which built-in widgets and themes they keep. Trimming the bundled themes to seven (#370) was a guess. Today the only signals are issues from the few who report, stars, and GitHub's download count per release.

A switch people have to turn on would leave those numbers thin and skewed toward the most engaged people, so this proposes a report that's on by default and can't identify anyone, with a clear notice and a one-click off.

StableBar sends nothing about its use today. The privacy policy (https://stablebar.app/privacy.html) says "no account and no analytics", and the Product Hunt page says the same, so both change before the release that turns this on.

Proposal

Anonymous usage data, on by default, with no identifier.

Notice and off switch

  • Setup shows what's sent, with the Share usage data switch on the same page, so turning it off takes one click.
  • People who update from a release without this see a one-time notice with the same switch.
  • No report goes out before the person has seen the notice, in setup or after updating.
  • The release notes of the release that turns it on say so.
  • Settings → General gets a Usage data group next to Updates, with the switch and Show what's sent, which shows the exact report the way Copy bug report does.
  • It's an app preference like the update checks, not a configuration property, so a shared configuration, a theme or a package can't change it.
  • Turning it off stops sending at once.

What's sent, at most once a day per Mac while the bar runs, as one small JSON report over HTTPS:

  • StableBar version and update channel (stable or beta).
  • macOS version, Mac family (MacBook Air, MacBook Pro, iMac, Mac mini, Mac Studio, Mac Pro), how many displays and whether one has a notch.
  • Whether the bar replaces the menu bar or sits below it, and the workspace tool (AeroSpace, yabai, OmniWM, macOS Spaces or none).
  • The theme's ID when it's bundled or from the Store, which built-in widget kinds are on the bar and how many of each, how many script widgets, profiles and screen setups, and the IDs of installed Store packages.

There's no install ID: nothing ties one report to the next, and the Mac remembers only the day it last sent one. The totals count daily active installs, not people, and the receiving end doesn't keep IP addresses. Homebrew's analytics work the same way: on by default, with no per-install ID or IP address kept (https://docs.brew.sh/Analytics).

Never sent: any identifier for the Mac, the person or the install, configuration values, scripts and commands, file paths, the names of custom widgets, themes or packages from other sources, calendar, window or app data, and crash reports. Copy bug report (#93) already gathers most of these facts in Sources/StableBar/BugReport.swift (MacFacts, ConfigurationSummary), so the report can reuse them.

Docs: the privacy policy and the Product Hunt text, before the release that turns it on, the Settings page in docs/, and an entry in DECISIONS.md for what may be collected and that it carries no identifier.

Open questions for the maintainers

  • Where reports go: a hosted, privacy-focused service (TelemetryDeck, for instance) or a small endpoint we run. An SDK would be a new dependency, so a plain HTTPS request is better either way.
  • Whether a report with no identifier, on by default, is enough under EU rules on reading facts from a device. Someone who knows the law should check before it ships.
  • Whether to publish the totals, on the website or in the repository, so people see what their data is used for.

Possible today

No. GitHub counts DMG downloads per release, but not active installs, the versions in use, setups or widgets. Update checks read the appcast on GitHub, which gives no counts. Bug reports carry the environment only for the people who file one.

Related

  • #333 / #338: crashes stay on the Mac and leave it only in a GitHub issue the person submits. This doesn't change that; sending crash reports automatically would be an issue of its own.
  • #93 / #341: Copy bug report gathers the same facts about the Mac and the configuration.
  • #378: the privacy policy, which has to change with this.
  • #22: update checks, which can be turned off in Settings → General → Updates.

Triaged by Claude Code (Claude Opus 5.5).

Dominant language
Swift
Stars
184
Forks
12
Avg merge
3h 50m
Merged PRs (30d)
387

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Seb-GRAF/StableBar

All issues in Seb-GRAF/StableBar

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.